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PREFACE 

This manual enables the user to employ the TX990 Operating System, in its standardized or 
customized modular configuration (including associated utiUty programs), with the user's 
standardized or customized hardware configuration. 

The sections and appendixes of this manual are organized as follows: 

I General Description — Provides a general description of the TX990 Operating System and 
its utility programs. 

II Loading the Operating System — Provides several alternative step-by-step procedures for 
loading the Operating System. 

f^^- III Operator Communication Package (OCP) — Describes the keyboard commands available 

to the operator for communicating interactively with the TX990 Operating System (e.g., 
to load a program, abort a task, abort an I/O operation, debug a program, set and clear 
breakpoints, et al). 

IV Control Program - Describes how to use the Control Program to load and execute program 
from the console. 
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V Programming Tasks — Describes how to program user tasks to run under TX990. 

VI Executive Supervisor Calls — Describes how the user can employ the executive manage- 
ment capabiHty of the Operating System through programmed supervisor calls. 

VII Device and File I/O Supervisor Calls — Describes how the user can employ the executive 
management capabiHty of the Operating System for controlling an input/output device or 
file. 

VIII Diskette OCP System Utihty (SYSUTL) Program — Describes the keyboard commands 
available to the operator for communicating interactively with diskette devices and files. 

IX System Generation (GENTX) Utility Program — Describes how the user can customize an 
operating system for a specific hardware and software configuration. 

X Diskette/Disc Backup and Initialize (BACKUP) Utility Program - Describes how to copy 
(or backup) and verify diskettes, as well as initialize new diskettes. 

XI Object Manager (OBJMGR) UtiUty Program — Describes how to copy standard and 
compressed object modules from diskette-, cassette-, or card-files onto diskette or cassette 
files and how to organize the files by deleting or adding modules. 

XII LIST80/80 (LIST80) Utility Program - Describes how to copy 80-character records 
from one device or file to another. 

XIII Diskette Dump (DSKDMP) Utility Program — Describes how the user can load, display, 
and modify diskettes on an allocation unit basis. 
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A List of Supervisor Calls — Provides a list of all the TX990 Operating System supervisor 
calls. 

B Device Character Sets - Lists the character sets for the 91 1 VDT, 913 VDT, 733, 743 or 
820 Data Terminals, 804 Card Reader, 810, 306, 2230, 2260 and 588 Line Printers, 
33 ASR Teletypewriter. 

C User-Supplied Modules — Describes user-supphed software modules that may be required 
for unique peripheral devices, user's extended operations, or user supervisor calls. 

D Glossary - Clarifies selected words used in this TX990 Operating System Programmer's 
Guide. 

E TX990 Compatibility with RX990 and DXIO - Describes the considerations to be met 
to achieve upward compatibility of tasks from the TX990 Operating System to the 
RX990 or DXIO Operating System. 

F Compressed Object Code Format - Describes the compressed object code format. ^^^^^ 

G Task State Codes — Lists and describes the task state codes. 

H Printout of Fatal Task Error Codes or Display of Illegal Interrupt Code — Lists and 
describes the fatal task error codes and the illegal interrupt code. 

I I/O Error Codes — Lists and describes the I/O error codes available to the user, when 
coding a program, for printout or display on a terminal device. 

J System Tasks - Describes the eight system tasks capable of being included in the TX990 ^^ 

Operating System. 

K System Generation using DXIO Release 3.0 - Steps involved in TX990 system generation 
on a DXIO system. 

L Support for the 32 I/O Module — Describes the I/O supervisor call and system generation 
support for the 32 I/O module supported by TX990 as a special device. 

M Support for the 5MT/6MT Module — Describes the I/O supervisor call and system 

generation support for the 5MT/6MT special device supported by TX990. /^ 

The following documents contain additional information related to the TX990 Operating System 
and are referenced herein this manual: 

Title Part Number 

Model 990 Computer Terminal Executive Development 946258-970 1 

System (TXDS) Programmer *s Guide 

Model 990 Computer TMS9900 Microprocessor Assembly 94344 1 -970 1 

Language Programmer *s Guide 

Model 990 Computer Model FD800 Floppy Disc System 945253-9701 

Installation and Operation 
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Title Part Number 

Model 990 Computer Model 913 CRT Display Terminal 943457-9701 
Installation and Operation 

Model 990 Computer Model 911 Video Display Terminal 945423-970 1 
Installation and Operation 

Model 990 Computer Model 733 ASR/KSR Data 945259-970 1 
Terminal Installation and Operation 

Model 990 Computer Model 804 Card Reader Installation 945262-9701 
and Operation 

Model 990 Computer Models 306 and 588 Line Printers 94526 1 -970 1 
Installation and Operation 

Model 990 Computer PROM Programming Module 945258-9701 
Installation and Operation 

990 Computer Family Systems Handbook 945250-970 1 

Model 990 Computer Communications Systems 945 409-970 1 
Installation and Operation 
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Model 990 Computer DXIO Operating System 
Programmer's Guide 

Model 990 Computer Communications 
System Software 

Model 990/10 Computer RX990 
Operating System Programmer's Guide 
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SECTION I 
GENERAL DESCRIPTION 



1.1 OVERVIEW 

The TX990 operating system is an executive that controls task execution in a real time environ- 
ment. TX990 executes in the Model 990/4, 990/5, or the Model 990/10 Computer. The memory 
protect hardware option (Model 990/4) and memory mapping option (Model 990/10) are not 
used by TX990. The maximum memory size is 56K bytes in the Model 990/4 Computer, and 62K 
bytes in the Model 990/5 and Model 990/10 Computers. 

TX990 may be customized to provide many features for the user and configured to save memory 
by excluding features which are not desired. A minimum TX990 system includes a task scheduler, 
interrupt handler for the clock, and a supervisor call interface, and occupies about 4K bytes of 
memory. Additional modules and features (e.g., file management, operator communications 
package) are optional according to application requirements. 

The task scheduler provides multiple priority level scheduling of Central Processor Unit (CPU) 
time and maintains a list of active tasks by priority. There are 131 priority levels available for user 
tasks. The scheduler features preemptive scheduling to support real-time event-driven applications 
as well as time-sharing applications. During system generation, the user can specify the scheduler to 
be a real-time scheduler without time slicing or can specify the scheduler to be time slice oriented. 
If time slice oriented, the time slice value is also specified during system generation. 

The interrupt handling software operates in conjunction with the prioritized interrupt scheme to 
allow the user to assign high interrupt priorities to critical devices or input lines. The clock-interrupt 
handler is included in the operating system to support scheduling and time-dependent supervisor 
calls. The user may also include custom interrupt handlers. 

Tasks request the support of the operating system by executing supervisor calls (SVCs). SVCs are 
routed through a supervisor call interface to an associated supervisor call processor. A substantial 
number of file management supervisor calls and task control calls are supported by the operating 
system. The user may also include custom supervisor call processors if desired. 

Tasks that execute under TX990 may be classified as either dynamic tasks or tasks linked into the 
operating system. When a TX990 operating system is generated, its various parts must be link edited 
to form a single linked object module, which can be loaded into memory and executed as an 
operating system. Any system or user tasks linked with the other system modules are loaded into 
memory when the system is booted, and are memory resident. 

Other tasks, called dynamic tasks, that are not linked with the system may reside in diskette files or 
other input media, such as magnetic tapes or cassettes. They may be dynamically loaded and execu- 
ted through the use of operator commands or supervisor calls. All user tasks not linked in with the 
system are dynamic tasks. (Dynamic tasks are loaded beyond the end of the operating system into 
memory called the dynamic task area.) The TX990 operating system may be customized to support 
a single dynamic task, multiple dynamic tasks, or no dynamic tasks. 
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NOTE 

When headers are shown in this manual, the abbreviation V.R.E. has 
the following meaning: 

V - represents the version number. The version number will 
change only when major changes are involved. 

R - represents the release number. The release number changes 
when a new release is performed. This number becomes 
zero when the version number changes. 

E — represents the ECN level. This number changes when the 
processor code changes, including changes by patches. 
The ECN level becomes zero when either the version 
number or the release number changes. 

For example, 1 .0.0 is the first release of a processor. '^ 

The abbreviation represents the date of the release where: 

YY is the year, and 
DDD is the Julian day 

78.244 represents September 1, 1978 

1.2 SUPPORTED HARDWARE 

The Model 990 Computer System hardware supported by TX990 include the following: 



^ 



Model 990/4, 990/5 or 990/10 Computer 

Programmer Panel 

FD800 Floppy Disk 

Model 911 or 913 Video Display Terminal •^ 

Model 733 "Silent 700"* ASR/KSR Data Terminal 

Model 743 Data Terminal 

Model 306 Line Printer 

Model 588 Line Printer 

Model 810 Line Printer 

Model 820 Keyboard/Printer 
Model 2230 Line Printer 

Model 2260 Line Printer ^«%s 

Model 804 Card Reader 
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• 33 ASR Teletype Data Terminal 

• 5MT/6MT Serial Interface Module 

• 32-In/Transition Detection Module 

• Model 979 A Magnetic Tape Unit (Model 990/5 or 990/10 Computers 
only) 

1 .3 FILE MANAGEMENT FEATURES 

The TX990 operating system optionally provides a file management package to support file 
structures and operations on diskettes and file-oriented devices. File management maintains a 
directory on all initialized diskettes in the system (see Section X on diskette initiaUzation). This 
directory can point to up to 48 files on the diskette. Diskette files consist of blocks of allocation 
units. An allocation unit is a logical division of the diskette. A diskette is divided into 333 allocation 
units, each consisting of six sectors. Tv^o basic file types are supported: sequential files and relative 
record files. Additionally, a special usage of the relative record file, called a program file, is 
supported. Some of the features of the file management package and file types are described in the 
follov^ing paragraphs. 

1.3.1 VOLUME NAMES. In addition to accessing files on a particular diskette drive (e.g., DSC, 
DSC2), file management optionally supports volume names for initialized diskettes. When a diskette 
is initialized, the user may assign it a one to four character volume name. If volume name support is 
included in the operating system, files on that diskette may be accessed through the volume name 
or the diskette drive device name. Addressing a diskette by volume name can be performed 
regardless of which drive it may be mounted on. 

Volume names are only supported by operating systems which include the module VOLUME (see 
the section on system generation). The standard TI supplied TX990 operating systems do not 
provide volume name support and diskettes may only be accessed by drive name. 

1.3.2 SEQUENTIAL FILES. The logical data records in a sequential record file must be accessed 
in a sequential manner (i.e., record 1 must be processed before record 2, etc.). When a sequential 
file is closed following an access, the operating system saves the position of the last access to the 
file. When the file is opened again, the next I/O call accesses the next logical record in the file 
instead of the first logical record of the file. To access the first logical record, the file must be 
rewound before the access. 

The last write operation performed on a file defines the current end of that file. No data can be read 
from the media that is beyond the current end of that file. The operating system prevents switching 
from a read, backspace or forward space operation to a write or write end-of-file operation until an 
end-of-file mark is read; however, when extending a file, a backspace of one record can be followed 
by write operations. This precaution prevents writing on data previously stored in a file. Similarly, 
the operating system prevents switching from a write operation to a read, forward space, backspace, 
or rewind operation until an end-of-file mark is written. 

Sequential files are blank compressed: i.e., when a logical record is written to a file, ASCII blanks 
are removed from the record. Blanks are restored to the record as it is read from the file. 

A sequential diskette file is comprised of logical records in blocks of allocation units. Whenever 
possible, the operating system will allocate contiguous blocks of allocation units. Diskette files 
may be created by either the Create File operation (code 90i6), or through the autocreate function 
when the file is opened. The operating system allocates additional allocation units to the file as 
Iff^^ needed when writing to the file. Each diskette file can contain a maximum of 20 noncontiguous 

♦Trademark of Texas Instruments Incorporated 
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blocks. Each file is terminated by an end-of-file mark. The beginning of the file can be located by 
executing a rewind file operation. Subfiles can be created by inserting end-of-file marks within 
the file. To add a new record to the end of a existing file or last subfile, read (or forward space) 
until the end-of-file mark is detected. Then backspace one record to position the media on the 
end-of-file record and write the new record(s). 

1.3.3 RELATIVE RECORD FILES. Relative record files are supported on diskette. A relative 
record file is comprised on contiguous and noncontiguous blocks of logical records, in or out of 
sequence (i.e., in random sequence). Each logical record is identified by a logical record number. 
Space is automatically allocated for a relative record file in blocks of contiguous allocation units 
when possible and, when not possible, in blocks of noncontiguous allocation units. There is no 
maximum number of logical records which can be placed in the file. However, there can be no more 
than 20 noncontiguous blocks of allocation units. The beginning of a relative record file is specified 
by logical record 0; the end of the relative record file is specified by the highest numbered logical 
record, which is automatically identified with an end-of-file mark. 

Logical records in a relative record file have a fixed length (which must be an even number of bytes) 
defined when the file is created. If the user tries to write a record larger than the specified record 
length, the record is truncated. If the record is shorter than the fixed record length, the record is 
binary zero filled. 



A program file contains several records of system overhead information, and then the linked object 
of a program (task, procedure, and overlays). The object code is in a format such that it can be 
loaded directly into memory by the image loader. By Unking programs into program files, the user 
may save diskette space and load time. Programs in program files take 25%40% less time to load 
than programs in compressed or noncompressed object files, and require approximately 25% less 
diskette space. 

1.4 LOGICAL I/O 

TX990 uses logical unit numbers (LUNOs) to represent physical devices and files. User tasks are 
coded to perform I/O to a LUNO, which is converted by the operating system to represent the 
physical device or file to which the LUNO is assigned. This enables a user to code an I/O operation 
independent of a specific hardware or file configuration. 

LUNOs may be assigned and released by a task using I/O Supervisor Call 00 operations or operator 
commands. A LUNO is assigned to a pathname, which may be either a device name (M characters) 
or a file name. Pathname format and syntax is described in the following paragraph. LUNOs may 
range in value from to FFie . 



^ 



By initially coding the logical record number to zero, the relative record file may be automatically 

written or read sequentially until the highest logical record number is reached. After a read or write 

l/0.file operation, the logical record number is incremented by the file management task; the logical 

record number is also incremented, or decremented, when the relative record file is rewound, 

forward spaced or backward spaced. The user may access any record at random by specifying the 

desired logical record number. Subsequent accesses may be either random or sequential. When ,mm^ 

another relative record number is specified out of sequence, access is at random. When none is ' 

specified, the next record in sequence is accessed. 

1.3.4 PROGRAM FILES. Program files are relative record files used to contain a program memory 
image; i.e., the linked object of one task segment and possibly one procedure segment and up to 
256 overlay segments. Program files are created by the Link Editor in IMAGE format. A program 
file may contain only one task and one procedure. 



^ 
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^^^^^ 1.4.1 PATHNAMES. A pathname may be the name of a device or a file. If a pathname represents a 

f' device, it is the name (1-4 characters, first must be alphabetic) assigned to that device at system 

generation (e.g., CSl , LP, CR). 

If a pathname represents a file, it has the following format: 

:<file name> / [<extension of file name>] 



<device name> 
< volume name> 



The first pathname component is optional, and is the name of the diskette drive or diskette volume 
which contains the file. A volume name is 1-4 characters, like a device name. The first character 
must be alphabetic; the remaining characters must be alphanumeric. A volume name may only be 
used if volume name support is selected during system generation (see Section IX). TI supplied 
TX990 systems do not include volume name support. The default value for this pathname 
component is defined during system generation. 



/(^^, 



>fS^P8^V 






j^^^^ 



The second pathname component consists of a colon (:) or period (.) and a 1-7 character file name. 
The first character of the file name must be alphabetic; the rest may be alphanumeric. 

The third pathname component is an optional 1-3 character extension of the file name. The first 
character must be alphabetic or blank; the rest must be alphanumeric or blank. If an extension is 
used, it must be separated from the file name by a slash (/) character. Optionally, the slash may be 
used alone, and the extension is interpreted to be three blanks. If no slash-extension is used, the 
extension is again interpreted as blanks. 



The following are examples of legal pathnames: 
:FILE 



DEV:FILE 
VOL:FILE 
:FILE/EXT 

DEV:FILE/EXT 
VOL:FILE/EXT 
DEV:FILE/ 
VOL: FILE/ 



File name, 1 to 7 characters; the device name is the 
default disk name. 

Device and file name; the extension is defined as 
blanks. 

Volume Name 1 to 4 characters; the extension is 
defined as blanks. 

File name and file extension name; the extension can 
be 1-3 chars. The device name is the default disk 
name. 

Complete pathname with no defaults. 

Complete pathname with no defaults. 

Defaults to a blank extension. 

Volume name, and file name, extension defaults to 
blank extension. 



Trailing blanks are allowed at the end of each field (as presented below), but embedded blanks are 
not allowed within the field itself. 

DSC:FILEW1?(/W1^ is the same as .:FILE/or :FILE 
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NOTE 

The above example assumes that DSC was generated as the default 
diskette name during system generation. 

1.4.2 I/O MODES. Three I/O modes of operation are employed: file mode, record mode, and 
character mode. I/O devices are designated for file, record or character mode of operation during 
system generation. An I/O device placed in the file mode is assigned to the calling task when an 
open I/O operation is employed and remains assigned to that calling task until a close operation is 
performed. An I/O device placed in the record mode remains assigned to the calling task only during 
execution of the individual I/O operation. In the record mode, a Video Display Terminal (VDT) has 
a LUNO assigned to enable execution of an I/O operation. However, a 911 or 9 1 3 VDT is also 
capable of being operated in the character mode. The character mode enables the VDT to be 
uniquely programmed and accessed by a station number, rather than a LUNO. 

1.5 SUPERVISOR CALLS 

Tasks request the support of the operating system by executing supervisor calls that are routed /^ 

through a supervisor call interface to an associated supervisor call processor. A substantial number 
of file management supervisor calls and task control calls are supported by the operating system. 
The user may also include his own custom supervisor call processors if desired. The different 
supervisor calls provided by TX990 are described in Sections VI and VII. 

1.6 OPERATOR INTERFACES 

TX990 optionally provides two operator interfaces, the Operator Communications Package (OCP) 

and the Control Program. A customized TX990 system may include neither, one, or both of the 

interface packages. The Control Program prompts the operator to load and execute any system ,„^. 

utiUty or user program. It also provides a means of passing parameters to the program. The Operator ^ 

Communications Package provides several commands which may be entered by the operator, and 

which perform various system functions (e.g., loading or executing programs, and debugging 

capabilities). The two operator interfaces are described in Sections III and IV. 

1.7 SYSTEM MEMORY LAYOUT CONSIDERATIONS 

Figure 1-1 shows the flow of control within a TX990 that includes all options. The task scheduler 
initiates execution of a user task as previously described. The task requests support of the executive 
by executing SVCs that are processed by the supervisor call interface. I/O supervisor calls are 
processed by the I/O Supervisor (lOS), and other supervisor calls are processed by their respective ^ 

supervisor call processors. Following execution of a supervisor call, the supervisor call interface 
returns control either to the calling task or to the task scheduler, according to the type of supervisor 
call. Interrupts from the clock and from active I/O devices are processed by the appropriate handler, 
which passes control to a common interrupt return after processing the interrupt. The common 
interrupt return passes control to the point in the task or executive at which the interrupt occurred. 

Figure 1-2 shows memory maps of four different configurations of TX990. The minimal system 
consists of the basic configuration shown in figure 1-2A. This provides a basic task scheduling and 
an interrupt processing monitor for a small static system. The minimal TX990 Operating System 
includes the data structures, task scheduler, supervisor call interface (with dummy supervisor call 
processors), and the interrupt processor. The user tasks in this type of system are linked and loaded 
with the system and perform any I/O operations without the aid of TX990. 

The addition of supervisor call processor modules, I/O supervisor call processor modules, and Device 
Service Routine (DSR) modules results in the configuration shown in figure 1-2B. In this configura- 
tion, it is necessary to link and load user tasks with the system. '^^ 
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The addition of OCP modules as shown in figure 1-2C adds the capability of operator interaction 
with the System using OCP commands. Addition of a dynamic task area, also shown in figure 1-2C, 
allows the operator to load a task or tasks by OCP command into the dynamic task area for 
execution. This capability, along with the use of OCP commands, enables debugging of tasks. Other 
user tasks must be linked and loaded with the operating system. 



^ 



The addition of file management modules, as shown in figure 1-2D, adds the capability of perform- 
ing file I/O operations with diskettes. This capability is necessary when the user wants to configure 
the Operating System using Terminal Executive Development System (TXDS). TXDS provides the 
user with those utiUties necessary for software development (see the TXDS Programmer's Guide, 
part number 946258-9701, for details). 
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Figure 1-2. Typical TX990 Operating System Configurations 
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A system configured as shown in figure 1-2A requires less memory for system purposes (overhead) 
(^^ than the other configurations, and is desirable where minimizing memory overhead is the most 

J important consideration. The additional support provided by the other configurations requires 

that more memory be available for system use. 

Systems configured as shown in figure 1-2 A and B support user tasks that are identified to the 
operating system during system generation and are linked and loaded with the operating system. 
These tasks occupy the area of memory beyond the area occupied by TX990, and may be placed in 
execution when the operating system is loaded. Operating Systems configured as shown in 
figure 1-2C and 1-2D also support these types of tasks but, in addition, they support a dynamic task 
area into which tasks may be loaded and executed by OCP commands. The dynamic task area 
consists of the available memory beyond the area occupied by the other user tasks. 
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SECTION II 
LOADING THE OPERATING SYSTEM 

2.1 INTRODUCTION 

The TX990 operating system may be loaded into memory from a diskette or a cassette. Basically, 
two methods may be used to load the operating system: (1) a ROM loader can execute and load the 
TXBOOT program from diskette which in turn loads the Operating System; or (2) a ROM loader 
can execute and load the operating system directly into memory from a cassette. More specifically, 
when the operating system is loaded from a diskette, a diskette/cassette ROM loader is utiUzed and 
the TXBOOT loader is loaded from a diskette; when the operating system is loaded from cassette, 
a diskette/cassette ROM loader or a card/cassette ROM loader is utiUzed. 

This section provides the step-by-step procedures required to achieve successful loading with each 
method. The initihzation procedure required to be performed after the operating system is loaded 
r^ into memory is also presented in this section. Two alternative initiahzation procedures are 

presented: one is used when an Operator Communication Package (OCP) is supplied with the 
operating system and the other is used when the TX990 Control Program and no OCP is supphed 
with the operating system. Any operator interaction with an operating system that does not include 
OCP capability must be provided by either user tasks or user-supphed system modules. At the end 
of this section, a procedure is provided to manually restart the system in event a system failure does 
not cause the contents of memory to be altered. 

When an error occurs, the error code is displayed by the indicators on the front of the Programmer 
"^^ Panel and the FAULT indicator is turned on. (See Appendix H, Printout of Fatal Task Error Codes 

or Display of Illegal Interrupt Code.) When an Operator Panel is used in the system, any error which 
occurs during loading causes the FAULT indicator to turn on and stay on. 

2.2 LOADING THE TX990 OPERATING SYSTEM 

The following paragraphs describe four methods for loading a TX990 operating system. 

2.2.1 LOADING FROM DISKETTE. Proceed as follows: 



/^^^^^\ 



/!^^^. 



1. Insert one of the three operating system diskettes (i.e., the diskette which contains the 
913 VDT operating system, the 733 ASR operating system, or the 911 VDT operating 
system) into any diskette drive. 

2. Sequentially depress the HALT/SIE, RESET, and LOAD switches on the front of the 
programmer panel. The TXBOOT program will now load into memory, followed by the 
TX990 operating system. 

NOTE 

The ROM loader tries to load from each of the first four diskette 
drives, beginning with diskette drive 0, until a READY drive is 
found. If none of the diskette drives indicate READY, the ROM 
loader will load from the cassette drive that is in the PLAYBACK 
mode and in the READY state. 
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3. When successful loading of the TXBOOT program and the operating system is completed, 
observe the following printed output or display from the system console (provided the 
Initial Start Task (STASK) module-feature is supplied with TX990): 

TX990 V. R. E YY.DDD 

MEMORY SIZE (WORDS): 16384 AVAILABLE: 5940 

(where the memory size printout or display is in decimal numbers specifying the quantity 
of memory words; the size, in words, of the dynamic task area is printed out as available 
memory). 

NOTE 

1. When the user does not include a task that produces an 
indication of successful loading of the operating system, the 
only possible way to verify successful loading is by usage of the 
operating system. 

2. The operating system diskette being used during the loading 
procedure must have the diskette boot program written on 
allocation units through 4, and the system file pathname must 
be defined. All standard TI diskettes have the diskette boot and 
the system file pathname previously defined; however, if the 
user wants to create an operating system diskette, the diskette 
boot program can be written and the system file pathname can 
be defined by using the Set System File (SF) command from 
the Diskette OCP System Utility (SYSUTL) Program. For 
information relating to SYSUTL, see the Diskette OCP System 
Utility (SYSUTL) Program section in this manual. 

4. After loading of the operating system is completed (i.e., after the printed output or 
display appears on the system console as specified in the previous step), perform the 
initialization procedure presented in paragraph 2.3. 

2.2.2 LOADING FROM CASSETTE USING DISKETTE/CASSETTE ROM LOADER. Proceed as 
follows: 

1. Place the cassette which contains the TX990 operating system in either of the two 
cassette drives of the 733 ASR terminal. 

NOTE 

For operating instructions covering the cassette unit, refer to the 
Model 990 Computer 733 ASR/KSR Data Terminal Installation and 
Operation Manual, part number 945259-9701. 

2. Rewind the operating system cassette. 

3. Place the cassette unit in the PLAYBACK mode and in the READY state. 

4. Press the HALT/SIE switch and then the RESET switch on the Programmer Panel. 



.^-m^ 
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5. Place the number OO8O16 into memory address OO8O1 5 as follows: 

a. Press the CLR switch and the 8 switch on the Programmer Panel to set the displayed 
value to OO8O16 . 

b. Press the ENTER MA switch on the Programmer Panel. 

c. Press the MDE switch on the Programmer Panel. 

6. Load TX990 into memory by pressing the LOAD switch on the Programmer Panel. 

7. When loading of the operating system program is completed, observe the following 
printed output or display from the system console (provided the Initial Start Task 
(ST ASK) module-feature is supplied with TX990): 

TX990 V. R. E YY.DDD 

MEMORY SIZE (WORDS): 16384 AVAILABLE: 5940 

(where the memory size printout is in decimal numbers specifying the quantity of 
memory words; the size, in words, of the dynamic task area is printed as available 
memory). 

8. After loading of the operating system is completed (i.e., after the printed output or 
display appears on the system console as specified in the previous step), perform the 
initialization procedure presented in paragraph 2.3. 

2.2.3 LOADING FROM CASSETTE USING CARD/CASSETTE ROM LOADER. Proceed as 
follows: 

1. Place the TX990 operating system cassette in either of the two cassette drives of the 733 
ASR terminal. 

NOTE 

For operating instructions covering the cassette unit, refer to the 
Model 990 Computer Model 733 ASR/KSR Data Terminal 
Installation and Operation Manual, part number 945259-9701. 

2. Rewind the operating system cassette. 

3. Place the cassette unit in the PLAYBACK mode and in the READY state. 

4. If the system has an Operator Panel instead of a Programmer Panel, proceed to the next 
step. If the system has a Programmer Panel, press the HALT/SIE switch and then the 
RESET switch. 

5. Load the operating system into memory by pressing the LOAD switch on the 
Programmer Panel. 
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6. When loading of TX990 is completed, observe the following printed output or display 
from the system console (provided the Initial Start Task (STASK) module-feature is 
supplied with TX990): 



TX990 V.R.E 



YY.DDD 






MEMORY SIZE (WORDS): 16384 



AVAILABLE: 5940 



(where the memory size printout is in decimal numbers specifying the quantity of 
memory words; the size, in words, of the dynamic task area is printed as available 
memory). 

7. After loading of the operating system is completed (i.e., after, the printed output or 
display appears on the system console as specified in the previous step), perform, the 
initialization procedure presented in paragraph 2.3. 

2.3 INITIALIZATION 

Two initiaUzation procedures are available: one for use when OCP is included in the operating 
system and the other for use when the Control Program is included. When OCP is included in the 
operating system, OCP commands may be entered on a system console such as a 733 ASR Data 
Terminal, or a 913 or 91 1 Video Display Terminal. The system console is defined during the system 
generation, and LUNO is assigned to the system console device at that time. Refer to table 2-1 for 
a hst of the standard TX990 device names. 

Table 2-1 . Standard TX990 Device Names 



Device 

733 ASR/KSR Keyboard/Printer 

743 KSR Keyboard/Printer 

820 KSR Keyboard/Printer 

733 ASR Cassette Unit 1 (Unit on left) 

733 ASR Cassette Unit 2 (Unit on right) 

Line Printer 

Card Reader 

913 or 91 1 Video Display Terminal 

Dummy 

Diskette Unit 1 (Unit on left) 

Diskette Unit 2 (Unit on right) 

Communication Device 

Teletype Keyboard/Printer^ 

Teletype Paper Tape Reader^ 

Teletype Paper Tape Punch^ 

^ Supported by Texas Instruments as a nonstandard item. 

2.3.1 INITIALIZATION USING OCP. Proceed as follows: 

1 . Enter an exclamation point (!) at the keyboard of the system console. This activates OCP, 
which responds by printing a period (.) to request entry of a command. 



Device Name 

LOG, ASR 

LOG, ASR 

LOG, KSR 

CSl 

CS2 

LP 

CR 

CRT, LOG 

DUMY 

DSC 

DSC2 

COM 

LOG, ASR 

PTR 

PTP 






/-^ 



^ 
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2. Assign LUNO 1 to a printing or display device on which information is to be displayed or 
printed. Table 2-1 lists device names in the operating system supplied by Texas 
Instruments. The standard TX990 assigns LUNO 1 to the system console. The following 
is an example of a command to assign LUNO 1 to a line printer. The command is 
followed by a carriage return. 



.AL,1,LP. 

3. When TX990 includes date and time support, initiahze the date and time. The following 
command initializes the time and date to 3:42 P.M., February 3, 1976. The command is 
followed by a carriage return. 

.10,1976,2,3,15,42. 

The operating system responds by printing time and date information (updated 
approximately), in the following format: 

15:42:18 FEB 3, 1976 

At this point, other commands may be entered to perform available functions. The OCP commands 
are described in Section IIL 

2.3.2 INITIALIZATION USING THE CONTROL PROGRAM. Proceed as follows: 

1. Enter an exclamation point (!) at the keyboard of the system console. This activates the 
Control Program, which prints the following heading and prompt: 

TXDS V.R.E YY.DDD 

PROGRAM: 

2. Insert the TX990 parts diskette in drive 1 . 

3. Activate the OCP System Utility Program (SYSUTL) by responding to the PROGRAM: 
prompt as follows: 

f^ PROGRAM: :SYSUTL/SYS* 

4. Initialize the time and date by responding to the SYSUTL OP: prompt as follows: 

SYSUTL V. R. E YY.DDD SYSTEM UTILITY 

OP:ID, <year>, <month>, <day>, <hour>, <minute>. TE. 

SYSUTL returns controls to the Control Program. 

2.4 MANUAL SYSTEM RESTART 

When the TX990 operating system is used in a Model 990 Computer equipped with a Programmer 
Panel, it is possible to restart the system without performing another loading procedure. A restart is 
appropriate in the event a system failure did not alter the contents of the system area of memory. 
To restart the system, perform the following steps at the Programmer Panel: 
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1 . Transfer control to the Programmer Panel by pressing the HALT/SIE switch. 

2. Press the RESET switch. 

3. Press the CLR switch and observe that the indicators of the display are not lit. 

4. Press the 8 switch and the 10 switch, setting a number of OOAOig in the display. 

5 . Press the ENTER PC switch. 

6. Press the RUN Switch. 

NOTE 

A standard Tl-supplied TX990 Operating System does not execute 
Initial Start Task (STASK) after a restart operation and, therefore, 
no display or printout is presented on the system console. ^ 

7. Perform the initiaUzation procedure presented in paragraphs 2.3.1 or 2.3.2. 



/""W^ 
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SECTION III 
OPERATOR COMMUNICATION PACKAGE (OCP) 

3.1 INTRODUCTION 

OCP allows the user to interactively request actions from the operating system through a terminal 
(e.g., 733 ASK, 743 KSR, 33 Teletype, 820 KSR, 911 or 913 VDT). Actions are initiated by the 
user by responding to the OCP command prompt (a period) with one of the OCP commands de- 
scribed in paragraph 3.5. 

Processing of operator commands is performed by five or more modules of the Operator 
Communication Package (OCP). OCP consists of four required modules and five optional command 
processor modules. These modules are described in the system generation section of this manual. 
The user may modify the OCP commands, add one or more command processors to a command 
j^ processor module, or add one or more command processor modules to OCP. 

3.2 ACTIVATING AND DEACTIVATING OCP 

In a TX990 system which includes OCP, it is initiated at the system console by entering an 
exclamation mark (!). OCP responds by prompting for a command, displaying a period (.): 



^p^ OCP may not be activated in a system which does not have the OCP modules linked-in (i.e., OCP 

may not be executed as a dynamic task). 

OCP is deactivated by issuing the OCP Terminate (TE) command in response to a prompt: 

TE. 

3.3 LUNOs 

OCP uses two LUNOs, 1 and 2. LUNO 1 is assigned to the device to which all messages or output is 
to be directed. LUNO 2 is assigned to the device which contains a file (e.g. object program) being 
/0^ input. 

3.4 COMMAND FORMAT AND SYNTAX. 

Each command consists of a command word, optionally followed by one or more operands. OCP 
recognizes a command by the first two letters of the command word; these letters may be followed 
by additional letters or by blanks. One or more blanks, or a comma, may separate a command word 
and operands. However, embedded blanks are not allowed within the command word or an 
operand. More than one command may be entered in a single Une, which may contain up to 72 
characters and must be terminated by a carriage return (NEW LINE on 911 or 913 Video Display 
Terminal). When more than one command is entered on one line, each command must be 
terminated with a period (the period may be omitted following the last command on the line). 
When an error is detected in a command, any subsequent command on that line is ignored. Two 
consecutive commas are interpreted as a null operand, which may be used to omit an optional 
operand. When a null operand is entered for a nupieric operand, the null operand takes the value of 
zero. When a null operand is entered for a character operand, the null operand takes the value of a 
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blank. If a command generates printout to a hardcopy device such as a 733 ASR, the printout can 
be aborted by pressing the ESCape key. If a Une is entered in error and if the carriage return has not 
yet been entered, the operator may press the RUB OUT key. This deletes the entry from the OCP 
input buffer, and the user can then enter a correct command. 

NOTE 

All numeric OCP inputs are assumed to be hexadecimal numbers. 

The following examples illustrate the manner in which OCP interprets equivalent commands entered 
in different ways. The commands in the examples are equivalent and valid. 

.DMEM,0000,0010. The complete command word is entered with two 

hexadecimal operands separated by commas and 
terminated with a period. 

•^^ 10 The command word is entered in two-letter form; 

blanks are used as separators; leading zeros are 
omitted; and the period is omitted. (Period is not 
omitted when another command is entered on the 
same line.) 

.DMEM, 10 The complete command word is entered; an addi- 

tional blank is entered; a comma is used as a separator 
in one place and a blank in another. 

.DM,, 10 The command word is entered in two-letter form, and 

first operand is entered as a null operand. 

.DMXXX,0000 10 The first two letters of the command word are fol- 

lowed by other letters; a blank is used as a separator. 

.DM 10 XYZ 55 This is the same as the second example except for 

additional operands, which are ignored. 

In subsequent definitions of OCP commands, the following notation is used. 

• Angle brackets < > enclose items supphed by the user 

• Brackets [ ] enclose optional items 

• Braces ] \ enclose alternative items, one of which must be entered 

• An elhpsis (...) indicates that the preceding item may be repeated 

• Items shown in capital letters must be entered as shown 

3.5 OCP COMMANDS 

The OCP commands are divided into the following groups: task support commands, debugging 
commands, I/O utility and status commands, time and data commands, and the termination 
command. Table 3-1 shows every OCP command and its syntax. 
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Available only 
with multiple 
dynamic task 
support. 



AL I 

ALUNO) 

RL I 

RLUNO I 

LP 
LPROG 

LR j 

LRPROGJ 

EX 
EXECUTE 

IT 
ITASK 

IR I 

IRTASK) 

IP J 
IPROC I 

DT 
DTASK I 



DP 
DPROC 



JDM j 

Idmen) 

[LM 

Ilmen 

JSB I 
isBKPTI 

(CB 
IcBKPT 

IAD I 

{add) 



jsu 

I SUB 



JM I 
JMPI 



Table 3-1. Syntax of OCP Commands 
OCP Task Support Commands 

,<luno>,<pathname>. 

,<luno>, 

,<pathname>[,t<priority>] [P] ] 
,<pathname>[,[<priority>] [P]] 
,<task id>[,<parml>[,<parm2>] ]. 

,<pathname>,<task id> [,<priority>] [,<procedure id>] [,P] [,N) 

,<pathname>,<taskid>[,<priority>] [,<procedure id>] [^] [,N] 
,<procedure id>. 

,<task id>. 

,<procedure id>. 
OCP Debugging and Error Recovery Commands 

,<starting address>[,<ending address>] . 

,<address>,<value>[,<value>] . . . 

,<address>. 

[,<address>]. 

,<value>,<value>. 

,<value>,<value>. 

,<address>,<address>. 
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Table 3-1. Syntax of OCP Commands (Continued) 
OCP Debugging and Error Recovery Commands (Continued) 



■'■'*^%. 



DW 
DWKSP 


,<task id>. 


KT 
DTASK 


,<task id>. 


KI 
KIO 


,<luno>. 


TR 
TRACE 


[,<address; 



OCP I/O utility and Status Request Commands 



y<*^ 





RE 
REWIND 


,<luno>. 




FS 
FSPACE 


,<luno>,<number> 




BS 
BSPACE 


,<luno>,<number> 




ST 
STASK 


[,<tasklD>]. 




SI 
SIO 




[,<luno>] 


Available only with 
multiple dynamic 


SP 
SPROC 


[,<procedure id>). 


task support. 









ym^^^^^ 



OCP Time and Date Commands 



ID 
IDATE 

TI 
TIME 



,<year>,<month>,<day>,<hour>,<minute>. 



TE 
TERMINATE 



OCP Termination Command 



y^flW^^K 
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Each group of commands is discussed in detail in a subsequent paragraph. 

3.5.1 OCP TASK SUPPORT COMMANDS. These commands are processed by either module 
OCPLRT or module DOCPLRT, and enable the user to assign and release LUNOs, load programs 
into the dynamic task area, and execute programs, through a terminal. DOCPLRT must be used in 
place of OCPLRT to support multiple dynamic tasks. 

3.5.1.1 Assign Logical Unit Number (AL or ALUNO). The Assign Logical Unit (AL or ALUNO) 

command assigns a logical unit to a pathname. The syntax for the command is as follows: 

(ALUNO f »<luno>, <pathname>. 

The LUNO operand is a hexadecimal number from through FEig . In systems that include OCP, 
LUNO is a system LUNO and may not be assigned by the user. When a previously assigned LUNO 
is reassigned, the previous assignment is released unless a task is performing I/O to the LUNO. 

^ When a task is performing I/O to the LUNO, the LUNO is neither released nor reassigned and an 

^ ' error message is printed. 

The following are examples of ALUNO commands: 

AL,10,CR. Assign LUNO lOig to the card reader. 

ALUNO, 1 1,LP. Assign LUNO 1 1 16 to the line printer. 

^1^ AL,10,:FILE/SYS. Assign LUNO lOi^ to a disc file. 

Error messages are discussed in paragraph 3.6 and in Tables 3-2 and 3-3. 
Error messages 1 through 6 (Table 3-3) apply to the AL or ALUNO command. 

3.5.1.2 Release Logical Unit Number (RL or RLUNO). The Release Logical Unit (RL or RLUNO) 

command releases the assignment of a LUNO to a physical device or file. An attempt to release a 
LUNO to which a task is performing I/O results in an error message. The syntax for the command 
is as follows: 



J^^S\^ 



/^^^\ 



{ RLUNO } '<'""°>- 



The LUNO operand specifies a LUNO to be released. The following is an example of an RLUNO 
command: 

RL,1A. Release LUNO lAig. 

Error messages 1 through 4 (table 3-3) apply to this command. 
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3.5.1.3 Load Program (LP or LPROG). The Load Program (LP or LPROG) command reads the ^^,^ 

object code on the specified device and installs it in the dynamic task area. When a task that was ^^i 

previously installed in the dynamic task area has not terminated, the current task is not installed 
and an error message is printed. The snytax for the command is as follows: 

/LP \ ,<pathname>[ ,[<priority>] [ ,P] ] . 
(LPROG/ 

The pathname operand is the name of the input device or file appropriate for the module that 
contains the object code for the task. OCP assigns LUNO 2 to the device. The priority operand 
is the priority level, through 3, of the task. When the priority operand is omitted, priority level 3 
is assigned to the task. The third operand is the letter P to specify that the task executes in the 
privileged mode. When the third operand is omitted, the task executes in the nonprivileged 
mode. 



The task identifier (ID) of a task installed with the LPROG command is 10 



16- 



When loading from a cassette, the LPROG command processor does not perform a rewind operation '^ 

prior to reading the module. It is necessary for the user to position a cassette to the desired object 
module. When loading from a diskette file, the file is automatically rewound. 

The following examples show use of LPROG commands: 

LPR0G,CS1. Read the object module (i.e., the program or task) 

from the cassette in cassette drive 1 and install the 
module in the dynamic task area at priority level 

3. -^^^ 

LP,CR,2. Read the object module from the card reader and 

install the module in the dynamic task area at priority 
level 2. 

LP,DSC2:IBMUTL/SYS,3,P. Read the object module from the diskette in diskette 

drive 2 and install the module in the dynamic task 
area at priority level 3 as privileged. 

Error messages 1, 2, 5, 6 and 7 through 1 1 (table 3-3) apply to this command. 

3.5.1.4 Load Real-Time Program (LR or LRPROG). The Load Real-Time Program (LR or 
LRPROG) command reads the object code on the specified device and installs it in the dynamic 
task area. When a task that was previously installed in the dynamic task area has not terminated, 
the current task is not installed and an error message is printed. The syntax for the command is 
as follows: 

(LR ) 

ILRPROG / ,<pathname>[ ,[<priority>] [ ,P] ] . 

The pathname operand is the name of the input device or file appropriate for the module that 
contains the object code for the task. OCP assigns LUNO 2 to the device. The priority operand 
is the priority level, 1 through 7Fi6 of the task. When the priority operand is omitted, priority 
level 127 is assigned to the task. The third operand is the letter P to specify that the task exe- 
cutes in the privileged mode. When the third operand is omitted, the task executes in the non- -^^ 
privileged mode. 
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The task identifier (ID) of a task installed with the LRPROG command is lOje . 

When loading from a cassette, the LRPROG command processor does not perform a rewind opera- 
tion prior to reading the module. It is necessary for the user to position a cassette to the desired 
object module. When loading from a diskette file, the file is automatically rewound. 

The following examples show use of LRPROG commands: 

LRPROG, CSl Read the object module (i.e., the program or task) 

from the cassette in cassette drive 1 and install the 
module in the dynamic task area at real-time priority 
level 7Fi6. 

LR, CR1,2 Read the object module from the card reader and 

install the module in the dynamic task area at real- 
time priority level 2. 

LR, DSC2:IBMUTL/SYS,50,P Read the object module from the diskette in diskette 

drive 2 and install the module in the dynamic task 
area at real-time priority level SOig as privileged. 

Error messages 1, 2, 5, 6 and 7 through 1 1 (table 3-3) apply to this command. 

3.5.1.5 Execute Task (EX or EXECUTE). The Execute Task (EX or EXECUTE) command places 
the specified task in execution. Execution begins when the task becomes the oldest task on the 
active list for its priority level, and no task at a higher priority level is active. The syntax for the 
command is as follows: 

i EXECUTE / ><t ask id> [ ,<parameter 1 > [ ,<parameter2> ] ] . 

The task ID operand is a two-digit hexadecimal operand. The task ID of the task installed in the 
dynamic task area is lOie. Task IDs of resident tasks are assigned when the system is generated. 
The parameter operands are optional task parameters, each of which is a hexadecimal number of up 
to four digits. When the operands are omitted, TX990 supplies zeros. The task obtains the 
parameters by executing a Get Parametef supervisor call, described in Section IV. 

The following are examples of EXECUTE commands: 

EX, 10. Execute task lOie , installed in the dynamic task area. 

EX,11,4845,4C50. Execute task lli^, and passes the characters HELP to the task. 

.EXECUTE, 10,1C. Execute the task installed in the dynamic task area, and pass the 

value lCi6 (28) to the task. 

Error messages 1 and 12 (table 3-3) apply to this command. 

3.5.1.6 Install Task (IT or ITASK). The Install Task command loads an object module from a 
sequential file into the dynamic task area. The syntax of the command is as follows: 



JIT A SKI 



(ITASK) '<Pathname> , <task id> [ , [<priority>] [ , [<procedure id>] [ ,P] [ ,N] ] ] 
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The <pathname> is the name of the sequential file or device which contains the object module of 
the task being installed, and is required. 

The required <task id> parameter is the ID to be assigned to the installed task. Vahd IDs are in the 
range of lOi^ to EFie- If a task with same ID is already installed, the task is not installed and a 
message is returned! "ID IN USE." 

The optional <priority> parameter is the priority (0 to 3) at which the task will execute. The 
default value is 3, the lowest priority. 

<Procedure id> is the ID of a previously installed procedure which is to be attached to the task 
when loaded. The task is initialized to begin execution at the procedure entry point, i.e., the proce- 
dure end vector. If no value is given, no procedure is attached to the task. 

The letter P is used to specify that the task should execute in privileged mode; if not used, the task 
is nonprivileged. 

The letter N is used to prevent the input file <pathname> from being rewound before the task is 
loaded. If N is not used, the file is rewound. 

The following examples show the use of the Install Task command: 

ITASK, DSC: TASK/OBJ, 30, 3, 10, P, N 

Read the object module from file : TASK/OBJ and install it as task 30 le with priority 3. 
Attach procedure lOie and make the task privileged. Do not rewind the file. 

IT, CS1,CB. "^ 

Read the object module from CSl and install it as task CBi^ . The task is nonprivileged, has no 
attached procedures, and has priority 3. 

3.5.1.7 Install Real-Time Task (IR or IRTASK). The Install Real-Time Task command loads an 
object module from a sequential file into the dynamic task area. The syntax of the command is as 
follows: 




,^ 



,<pathname>,<task id>[,[<priority>] [,[<procedure id>] [,P] [,N] ] ] 

The <pathname> is the name of the sequential file or device which contains the object module of 
the task being installed, and is required. 

The required <task id> parameter is the ID to be assigned to the installed task. Valid IDs are in the 
range of lOj^ to EFig. 

The optional <priority> parameter is the real-time priority (1 to IFie) at which the task will 
execute. The default value is TFjg , the lowest priority. 

<Procedure id> is the ID of a previously installed procedure which is to be attached to the task 
when loaded. If no value is given, no procedure is attached to the task. 

The letter P is used to specify that the task should execute in privileged mode; if not used, the task "'^^ 

is nonprivileged. 
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The letter N is used to prevent the input file <pathname> from being rewound before the task is 
f^^^ loaded. If N is not used, the file is rewound. 

The following examples show the use of the Install Real-Time Task command: 

IRTASK, DSC: TASK/OBJ,30,5,10,P,N 

Read the object module from file :TASK/OBJ and install it as task 30 jg with real-time 
priority 5. Attach procedure lOig and make the task privileged. Do not rewind the file. 

IT,CS1,CB. 

Read the object module from CSl and install it as task CBi^. The task is nonprivileged, 
has no attached procedures, and has real-time priority 7Fi6 . 

3.5.1.8 Install Procedure (IPROC). The Install Procedure (IPROC) command reads the specified 
file and installs it in the dynamic task area. The syntax for the command is as follows: 

I IPROC • ,<pathname>,<procedure id> 

The <pathname> is the name of the sequential file or device which contains the object module of 
the procedure being installed, and is required. 

The <procedure id> specifies the procedure to be installed with the IPROC command. If a proce- 
dure with the same id is already installed, the new procedure is not installed and an error message is 
returned. 

r The end vector entry point of the procedure module is stored so that subsequent tasks installed and 

attached to this procedure may automatically begin execution within the procedure at this point. 

3.5.1.9 Delete Task (DTASK). The Delete Task command deletes a task from memory and returns 
the memory occupied by the task to the available memory pool in the dynamic task area. The 
syntax for the command is as follows : 

{dTASk} <taskid>. 

The task previously installed with an ITASK command using the same <task id> is deleted. If a task 
with the specified ID is not installed in the dynamic task area, no task is deleted, and an error 
message is printed. When a procedure is attached by an ITASK command to the task being deleted, 
the task is detached from the procedure. A task linked with the system may not be deleted. 

3.5.1.10 Delete Procedure (DPROC). The Delete Procedure command deletes a procedure from 
memory and returns the memory to the available memory pool in the dynamic task area. The 
syntax for the command is as follows: 



^jffiWy 



)nppnr \ <procedure id> . 



(DPROC/ 

The procedure previously installed with an IPROC command using the < procedure id> is deleted 
unless one or more tasks are attached. When one or more tasks are attached or a procedure with the 
specified ID is not installed, the procedure is not deleted, and an error message is printed. 
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3.5.2 OCP DEBUGGING AND ERROR RECOVERY COMMANDS. These OCP commands are 
processed by Command Processor module OCPSLD and OCPTLD, and enable the operator, by use "^ 

of the system console keyboard, to perform some real debugging operations; dumping and loading 
memory, which allows the user to patch his task or to examine different variables in memory; 
setting and clearing run-time breakpoints in a task; adding and subtracting hexadecimal addresses- 
calculating JMP instruction displacements; and dumping the current workspace of an executing 
task. These commands are described in the following paragraphs. 

3.5.2.1 Dump Memory (DM or DMEM). The Dump Memory (DM or DMEM) command causes 
OCP to print the contents of specified sequential memory locations on the device to which LUNO 1 
is assigned. The syntax for the command is as follows: 

IDMEM I '^s^^^^i^S^^dress>[,<endingaddress>]. 

The starting address operand is a one- to four-digit hexadecimal address of the first memory 
location to be displayed. The optional ending address operand is a one- to four-digit hexadecimal 
address of the last memory location to be displayed. When the ending address operand is omitted, ^^\ 

the ending address is equal to the starting address. Contents of eight memory words are printed 
on one line, following the address of the first memory location displayed. The contents are dis- 
played in hexadecimal representations and in ASCII character representations, with nonprinting 
characters printed as periods. OCP displays a multiple of eight words; when the ending address is 
omitted or when the ending address is greater than the starting address by 16 or less, one line is 
printed. Similarly, the last line printed includes the contents of the ending address and any addi- 
tional words required to fill the line. When the starting address is an odd value, the next lower even 
address is used. 

The following is an example of a DMEM command and the resulting display of memory contents: "^ 

DM,15,34. Display contents of memory locations OOlSie through 0034i6 . 

0014 = 07BA 0796 0568 05E2 0568 05E2 0568 05E2 .. 

0024 = 0572 05B0 057C 05BC 0568 05E2 0568 05C8 .. > II 

0034 = 0568 05E2 0568 05E2 0590 05D4 0568 05E4 T 

Error message 1 (table 3-3) applies to this command. On a computer equipped with TILINE*, an 

attempt to address a nonexistent memory address terminates OCP. On other computers, the com- /-n 

mand is executed, but gives unpredictable results. 

3.5.2.2 Load Memory (LM or LMEM). The Load Memory (LM or LMEM) command places 
values in memory at specified locations. The syntax for the command is as follows: 

(LMEM ] '<^ddress>,<value>[,<value>. . . .] 

The address operand is a one- to four-digit hexadecimal address into which the first value operand 
is placed. The value operand is a one- to four-digit hexadecimal representation of the value to be 
placed in a word of memory. When additional values are entered, they are placed in successive ad- 
dresses. When the address operand is an odd address, the value is at the next lower even address. 
The following is an example of an LMEM command: 

LM,0100,FFFF,1284. Place the values FFFFig and 1284i6 in memory words at ad- 

dresses 01 00 16 and 0102i6 , respectively. "^ 

*TILINE is a registered trademark of Texas Instruments Incorporated. 
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Error message 1 (table 3-3) applies to this command. On a computer equipped with TILINE, an 
attempt to address a nonexistent memory address terminates OCP. On other computers, the 
command is executed but the results are unpredictable. 

3.5.2.3 Set Breakpoint (SB or SBKPT). The Set Breakpoint (SB or SBKT) command sets a break- 
point in a task. A breakpoint may be set in any resident task or in a task that has been installed in 
the dynamic task area, whether or not the task is active. Setting a breakpoint consists of replacing 
the contents of the specified breakpoint location with a single-instruction loop (JMP $). 

CAUTION 

Do not mistakenly set the breakpoint outside of the task area, or a 
memory area other than the task area may be destroyed. 

As many as four breakpoints may be active at any one time. The syntax of the command is as 
follows: 






The address operand is a one- to four-digit hexadecimal address at which the breakpoint is set. The 
following is an example of an SBKPT command: 

SB,048C. Set a breakpoint at the instruction at address 048Ci6 . 

Error messages 1, 6, and 13 (table 3-3) apply to this command. On a computer equipped with 
TILINE, an attempt to set a breakpoint in a nonexistent memory address terminates OCP. On other 
computers, the command is executed, but the results are unpredictable. 

The user must be careful to set a breakpoint at the address of a single-word instruction, or at the 
address of the first word of a multiword instruction. Effects of setting breakpoints at other 
locations are unpredictable. 

3.5.2.4 Clear Breakpoint (CB or CBKPT). The Clear Breakpoint (CB or CBKPT) command clears 
one or all breakpoints in a task or system. A breakpoint may be cleared in any resident task or in a 
task that has been installed in the dynamic task area, whether or not the task is active. 

When a breakpoint occurs, a CBKPT command must be executed to continue execution of the task. 
Clearing a breakpoint consists of restoring the original contents of the breakpoint location. How- 
ever, when clearing a breakpoint is requested for a breakpoint location that no longer contains a 
single-instruction loop (JMP $) the contents of memory are not altered. The syntax for the 
command is as follows: 



{cBKPt} [5<^ddress::^ 
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The address operand is a one- to four-digit hexadecimal address of a breakpoint to be cleared. When 

the address is omitted, all current breakpoints are cleared. The following is an example of a CBKPT "^^"^ 

command : 

CBKPT,048C. Clear breakpoint at address 048Ci6 . 

Error messages 1,12, and 14 (table 3-3) apply to this command. 

3.5.2.5 Add (AD or ADD). The Add (AD or ADD) command provides the sum of two values. The 
syntax of the command is as follows: 

{add ) '<value>,<value>. 

The value operands are one- to four-digit hexadecimal numbers, and are added using the add 
machine instruction. The addition follows the rules that apply to the add instruction, and the result 
is not modified by the state of the Carry or Overflow bits following the operation. The following 
are examples of ADD commands and resulting sums: ^ 

ADD,300,700. Adds 300i6 to 700i6 and prints the sum OAOO16 . 

OAOO 

AD,7FFF,8000. Adds 7FFFi6 to 8OOO16 and prints the sum FFFF16, the maximum 

FFFF value that is represented without an overflow. 

AD,8000,8000. Add 8OOO16 to 8OOO16 and prints the four least significant digits of 

0000 the sum, 0000. "^ 

Error message 1 (table 3-3) applies to this command. 

3.5.2.6 Subtract (SU or SUB). The Subtract (SU or SUB) command subtracts the first of two 
specified values from the second, and prints the difference. The syntax for the command is as 
follows: 



I SUB f »<value>,<value>. 

The first value operand (subtrahend) is the value to be subtracted from the second value operand 
(minuend). Both operands are one- to four-digit hexadecimal numbers, and are subtracted using the 
subtract machine instruction. The subtraction follows the rules that apply to the subtract instruc- 
tion, and the result is not modified by the state of the Carry or Overflow bits following the opera- 
tion. The following are examples of SUB commands and resulting differences: 

SUB,500,A00. Subtract SOOie from AOOie , and prints the difference, SOOie . 

0500 

SU,FFFF,100. Subtract FFFFie (-1) from lOOje, and prints the difference, lOlig. 

0101 

SU,1000,300. Subtract lOOOig from 300i6, and prints the difference, F300i6 

F300 (-DOOie). 

Error message 1 (table 3-3) applies to this command. 
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^ 3.5.2.7 Jump Instruction (JM or JMP). The Jump Instruction (JM or JMP) command builds a jump 

f instruction having a displacement corresponding to the specified addresses. The JMP command 

prints an instruction word with a 1 as the first digit and the displacement in the two least signifi- 
cant digits. An asterisk follows the 1 and represents the second hexadecimal digit of a specific jump 
instruction; i.e., for JMP, 3 for JEQ, etc. The syntax for the command is as follows: 

(JMPf '^^^dr^ss>,<address>. 

The address operands are one- to four-digit hexadecimal addresses; the first is that of the jump in- 
struction being built; the second address is that of the instruction to which control is to be trans- 
ferred by the jump instruction. The following are examples of JMP commands and the resulting 
instructions: 

JMP,109A,10B0. Build a jump instruction to be placed at address 109Ai6 to jump to 

1*0A address lOBOig. 

^ JM,109A,1000. Build a jump instruction to be placed at address 109Ai6 to jump to 

1*B2 address IOOO16. 

Error messages 1 and 15 (table 3-3) apply to this command. 

3.5.2.8 Dump Workspace (DW or DWKSP). The Dump Workspace (DW or DWKSP) command 
causes OCP to print the contents of the workspace of a specified task. When the debugging OCP 
described previously is not included, this command will not execute. OCP also prints the task ad- 
dress and the workspace pointer register contents. The syntax for the command is as follows: 

/^^*N (DW ) 

' i DWKSP/ '<t^skid>. 

The task ID operand is the task identifier of the task. The task identifier is a one- or two-digit 
hexadecimal number assigned when the task was loaded. The following is an example of a DWKSP 
command and the resulting printout: 

DWKSP,OD. Print contents of workspace of task ODje . 

^ ADR: 20F0 WP: 20F6 

^ 20F6 = 06BE 06AE 06CA 06AC 06EA 070A 06EA 070A .> 

2106 = 05E4 0568 05E4 0568 05E4 0568 05E4 0568 



On the first line, OCP prints the starting address at which the task was loaded, and the contents of 
the workspace pointer register. On the next two lines, the contents of the 16 words of the work- 
space are printed in the format of the DM command. The address of the first word on each line is 
printed as a four-digit hexadecimal number, followed by an equal sign. The address on the first of 
these two lines is the address that is in the workspace pointer register. To the right of the equal sign 
are eight four-digit hexadecimal numbers that represent the contents of workspace registers 
through 7 in hexadecimal representation. The ASCII representation of the same values is printed 
further to the right, with periods substituted for nonprinting ASCII characters. The contents of 
workspace register 8 through F are printed in the same format on the next line. 



Error messages 1 and 12 (table 3-3) apply to this command. 
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3.5.2.9 KiU Task (KT or KTASK). The Kill Task (KT or KTASK) command forces termination of 

an executing task. If end action is specified by the task, it is taken. Otherwise, any I/O operations ^^ 

in progress are terminated in error; all assignments of file-oriented devices to the task are released; 
and any files that were opened are closed. The syntax for the command is as follows: 

(KT ) 

{kTASK/ '<t^skid>. 

The task ID operand is the task identifier assigned when the task was installed, and consists of two 
hexadecimal digits. The following is an example of a KTASK command: 

KTASK,2 1 . Force termination of task 2 1 16 • 

Error messages 1, 12, and 16 (table 3-3) apply to this command. 

3.5.2.10 Kill I/O Operation (KI or KIO). The Kill I/O Operation (KI or KIO) command terminates 
any I/O operation to the specified device. If an I/O operation to the device is in progress, that 
operation is terminated in error. The syntax for the command is as follows: 

{kio } '<i^"°>- 

The LUNO operand is a hexadecimal number, the LUNO assigned to the device on which I/O is to 
be terminated. When the specified device is file-oriented, the command also closes the file, which 
releases the assignment of the device to the task. The following example shows a KIO command: 

KIO,30. Terminate I/O to the device or file to which LUNO 30 le is assigned. 

Error messages 1 and 17 (table 3-3) apply to this command. 



{rewind} '<^^^^>- 



^^ 



•fSWfev 



3.5.2.1 1 Trace (TR or TRACE). Trace (TR or TRACE) displays the current contents of a memory 
location on the programmer panel lights. When the contents of memory change, the programmer 
panel lights will also change. It has up to one parameter. This parameter is the hexadecimal memory 
address. If no parameter is given, the standard display, the Program Counter (PC), will be displayed 
on the programmer panel. By entering the command with no parameter, the trace is, in effect, 
turned off. ^ 

TRACE [,<memory address>]. 

3.5.3 OCP I/O UTILITY AND STATUS REQUEST COMMANDS. These OCP commands are 
processed by Command Process Module OCPIOU or DOCPIOU, and enable the operator, by use of 
the system console keyboard, to perform various I/O utihty and status request commands. 
DOCPIOU should be included to support multiple dynamic tasks. 

3.5.3.1 Rewind Device (RE or REWIND). The Rewind Device (RE or REWIND) command 
initiates a rewind operation on a rewindable device or file. The syntax for the command is as 
follows: 



^ 



3-14 Digital Systems Division 




946259-9701 



^^rtWv 



The LUNO operation is a hexadecimal number, the LUNO assigned to the device or file to be re- 
f^^ wound. When the LUNO is assigned to a device that is not rewindable, the command is ignored. The 

following is an example of a REWIND command: 

RE,2C. Rewind the device to which LUNO 2Ci6 is assigned. 

Error messages 1,17, and 18 (table 3-3) apply to this command. 

3.5.3.2 Forward Space (FS or FSPACE). The Forward Space (FS or FSPACE) command forward- 
spaces a sequential file or device a specified number of records. When the file or device forward 
spaces to an end-of-file (EOF) record, it remains positioned at the record following the end-of-file 
record. The syntax for the command is as follows: 

(FSPACE/ '<l^no>,<number>. 

The LUNO operand is the LUNO to which the device or file to be forward -spaced is assigned. When 
^ the LUNO is assigned to a device other than a cassette or magnetic tape, the command is ignored. 

The number, a one- to two-digit hexadecimal value, is the number of records to be forward spaced. 
The following is an example of an FSPACE command: 

FS,1C,5. Forward space the device to which LUNO ICie is assigned 5 records. 

Error messages 1, 17, 18, and 19 (table 3-3) apply to this command. 



3.5.3.3 Backspace (BS or BSPACE). The Backspace (BS or BSPACE) command backspaces a 
sequential file or device a specified number of records. When the cassette tape is at the beginning-of- 
tape marker, the command is ignored. The syntax for the command is as follows: 

i BSPACE ) '^l^^o>''^^^^t)er>. 

The LUNO operand is the LUNO to which the device to be backspaced is assigned. The number, a 
one- or two-digit hexadecimal value, is the number of records to be backspaced. The following is 
an example of a BSPACE command: 

BSPACE,2E,10. Backspaces the device to which LUNO 2Ei6 is assigned lOi^ records. 

Error messages 1, 17, 18, and 19 (table 5-4) apply to this command. 

3.5.3.4 Task Status (ST or STASK). The Task Status (ST or STASK) command causes OCP to 
print the current status of all tasks. The syntax for the command is as follows: 

{sTASk} [<taskid>]. 
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No operand is required; however, if <task id> is supplied, only the status of that one task will be 
printed. The following is an example of an STASK command and the resulting printout: 

ORIGINAL CURRENT 
ID PRIORITY PF 



FO 


00 


Fl 


00 


OB 


01 


OC 


00 


OD 


01 


OF 


01 


16 


01 


10 


R3F 


21: 


18:36 



JUN 



RITY 


ADDR 

1F86 
IFEA 
1D62 
204E 
5CB4 


WP 


PC 


ST 


STATE 

04 
04 
04 
04 
04 


1 


26A2 
216E 


26A8 


2B04 


840F 


00 
04 




5E5A 


5E60 


62AE 


CCOF 


09 


7, 1978 











^ 



OCP prints a heading, followed by a line for each task. In the first column, OCP prints the task ID. 
OCP prints the installed priority level of the task in the second column. The third column shows 
the task's current priority if the task is active or suspended. The next four columns contain four- 
digit hexadecimal addresses. The first of these, under the heading ADDR, is the address of the 
task. Next, under the heading WP, is the value to be placed in the workspace pointer register when 
the task is executed. In the column headed PC is the program counter contents, and in the column 
headed ST is the status register contents. The contents of the WP, PC, and ST registers are the 
contents at the most recent execution of the task. The seventh column, headed STATE, contains 
the task state code used by task management. These codes are listed in Appendix G. The last 
column, headed PROC, is only specified if multiple dynamic tasks are allowed. It contains the 
procedure identifier if a procedure is attached to the task. It is blank when no procedure is attached 
to the task. 

Task identifiers and priority levels are assigned at system generation, except for tasks in the dynam- 
ic task area, which have identifiers and priority levels assigned by the IT ASK or IRTASK command. 

Task addresses are those into which the tasks were loaded when the system was loaded, or during 
execution of the ITASK or IRTASK command. 

3.5.3.5 Status of I/O (SI or SIO). The Status of I/O (SI or SIO) command-request causes OCP to 
print the status of all assigned LUNOs or of a particular LUNO. The syntax for the command is as 
follows: 



^ 



/■^^^V 



.^ 



No operand is required. The following is an example of an SIO command and the resultant 
printout: 



SI. 

LUNO PATHNAME 
FO DSC 
Fl DSC2 

00 LOG 

01 LOG 

06 DSC:TXCCAT/SYS 
10:11:10 JANS, 1977 



TASK ID 



SYSLUN 
Y 
Y 
Y 

N 
N 



^/*<^S^. 
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OCP prints a heading, followed by a line for each LUNO and, in the first column, OCP prints the 
hexadecimal digits of the LUNO. The PATHNAME column contains the device, or file name to 
which the LUNO is assigned; and the SYSLUN column contains YES for LUNOs designated for 
system use and NO for other LUNOs. The Task ID column contains hyphens for LUNOs that are 
not assigned to tasks, or the task identifier of tasks to which LUNOs are assigned. A LUNO for a 
file-oriented device is assigned to a task from the time the task issues an Open supervisor call. This 
call specifies the LUNO until the task terminates or issues a Close supervisor call for the LUNO. A 
LUNO for a record-oriented device is assigned to a task only during an I/O operation. If the status is 
requested for a LUNO which has not been assigned, the header line only will -be printed. 

SI,20. 

LUNO PATHNAME TASK ID SYSLUN 

3.5.3.6 Procedure Status (SP or SPROC). The Procedure Status (SPROC) command causes OCP to 
print the current status of procedures. The syntax for the command is as follows: 

SPROC [<procedureid>]. 

The status of the specified procedure will be printed. When the <procedure id> is omitted, the 
status of all procedures will be printed. The following is an example of a SPROC command and the 
resulting printout. 

SP 

ID ADR # TASKS 

27 BE60 01 

0:02:37 JAN 1, 

OCP prints a heading, followed by a line for each procedure. In the first column, OCP prints the 
procedure identifier. Column two contains the address at which the procedure was loaded. OCP 
prints the number of tasks to which the procedure is attached in the third column. Procedure 
identifiers are assigned by the IPROC command. The number of tasks to which the procedure is 
attached is incremented each time an ITASK command specifies attachment of that procedure and 
(^^ is decremented each time a DTASK command deletes a task to which that procedure had been 

attached. 

3.5.4 OCP TIME AND DATE COMMANDS. The OCP date and time commands are: 

• Initialize Date and Time (ID or IDATE) 

• Print Time and Date (TI or TIME) 

These OCP commands are processed by Command Processor Module OCPTAD and enable the 
operator, by use of the system console keyboard, to initiaUze time and date for the Operating 
System. The above hsted commands are described in the following paragraphs. 



r^' 
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3.5.4.1 Initialize Date and Time (ID or ID ATE). The Initialize Date and Time (ID or IDATE) 

command initializes the date and time values for the system. The syntax for the command is as A 

follows: 

ITDATF ( ^<y^ar>,<month>,<day>,<hour>,<minute>. 

The year operand is the four-digit decimal number of the years 1975 through 1999, and the month 
operand is the decimal number of the month, 1 through 12. The day operand is a one- or two-digit 
decimal number, 1 through 31, and the hour operand is a one- or two-digit decimal number, 
through 23. The PM hours are specified by the sum of 12 and the hour. The minute is the decimal 
number of the minute, through 59. The second is set to zero when the command is entered. After 
the command is entered, the time and date will be written to the log for verification. The following 
example shows an IDATE command: 

ID,1976,2, 12, 17,29. Initialize the time and date to 5:29 PM, February 12, 1976. 

5:29:00 FEB 12, 1976 

Error message 1 (table 3-3) applies to this command. 

3.5.4.2 Print Time and Date (TI or TIME). The Print Time and Date (TI or TIME) command 
causes OCP to print the time and date. The syntax for the command is as follows: 

|TI ] 

\time/ • 

The command requires no operands. The following example shows a TIME command and the 
resulting output: 

TI. 

9:29:12 FEB 13, 1976 

When the date and time have not been initialized, the time printed is the elapsed time from the 
most recent loading of the Operating System. 

3.5.5 OCP TERMINATION (TE) COMMAND. The syntax for the TERMINATE (TE) command 
is as follows: 

(TE ) 

(TERMINATE / 

The command requires no operands. 

3.6 ERROR MESSAGES 

OCP prints two categories of error messages. The messages in the general category are shown in 
table 3-2. These messages are not related to any specific command. The messages in the operand 
category apply to one or more operands of specific commands. These messages are listed in 
table 3-3 and are numbered to allow them to be associated with the commands to which they apply. 
The numbers do not represent an error code, but are arbitrarily assigned for identification purposes. 



^ 



Z^^^tK 



^^^%. 
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When more than one OCP command is entered on a line, and an error occurs, the command in error 
(or that caused the error) and all subsequent commands in the statement must be entered again. It is 
sometimes necessary to supplement the error message information with information obtained by 
executing other OCP commands (ST, SI, DM, DW, etc.) to determine which commands have 
executed correctly. System generation documentation provides information about the tasks actually 
in the system, their identifiers, and their priority levels. It is also helpful to enter the commands 
individually so that any error messages are printed following entry of the command. However, the 
user must exercise care to avoid reexecuting a command that executed correctly and will provide 
undesirable results if it is executed again. 

When LUNO 1 is assigned to a device that is off line, or when LUNO 1 is not assigned and a 
command is used which generates a listing (DMEM,STASK,SIO), OCP ignores the command and 
prompts the user with a period(.). 



/i^^\ 



Message 
* INVALID COMMAND * 



Table 3-2. OCP General Error Messages 
Meaning 

The command word is not valid. 



I/O ERROR, TERMINATED An I/O error was detected 

during reading of the command. 



OUTPUT ERROR 



An error was detected during 
output and execution of the 
command has been terminated. 



Recovery 



Check the command word, and 
reenter correctly. 

Input from the system console was 
not received correctly or the device 
timed out. 

This message is printed when LUNO 
1 has not been assigned. Check device 
for errors. 






UNDEFINED ERROR 



MISSING SYS MSG 



TX990 returned an error code to 
OCP that is not recognized by OCP. 



OCP could not locate the text for 
an OCP error message. 



This is a system error. Make another 
attempt to enter the command. If 
error reoccurs, reinitialize the 
system. 

OCP is incorrectly configured or 
incorrectly programmed. First verify 
that the proper OCP modules were 
linked with the system, and relink 
and reload the system if they were 
not. If all required modules were 
linked, and these modules were 
supplied by Texas Instruments, 
contact your Texas Instruments 
representative. If user-supplied 
OCP modules are involved, refer 
to error message information in 
paragraph 6.2.2 and verify the 
coding of the OCP module. 



r^' 
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^ SECTION IV 

CONTROL PROGRAM 

4.1 INTRODUCTION 

The TX990 Control Program provides a simple interface which allows a terminal operator/user to 
load and execute programs. It can also be used to pass parameters to a program being executed. The 
following paragraphs describe how to use the Control Program, as well as the mechanism used to 
pass parameters to initiated tasks (programs). 

4.2 ACTIVATING AND DEACTIVATING THE CONTROL PROGRAM 

The Control Program, like OCP, may not be executed unless it is linked in with the TX990 
operating system. Activation of the Control Program is different between systems which include 
OCP and systems which do not. 

■ In an operating system which does not include OCP, the control program is activated by entering an 

exclamation point (!) at a terminal. 

In a system which does include OCP, the Control Program must be activated through OCP: 

1 . Enter ! at a terminal, activating OCP. 

2. Respond to the OCP command prompt (.) as shown: 
r^ EX,16.TE. 

3. The above command executes task 16i6 (the Control Program) and terminates OCP. 

After the Control Program has been executed, the following printout or display is presented at the 
system console: 

TXDS 2.3.0 78.244 

PROGRAM: 

This display indicates that the Control Program is in execution and that the operator may respond 
to the PROGRAM: prompt by specifying the program to be loaded and executed. The display 
heading indicates the name of the monitor (TXDS), the revision status (Release 2.3, change level 
0), and the release date of the system (the 244th day of 1978). 

The Control Program may be terminated by entering only a return or a new line in response to the 
PROGRAM: prompt. OCP, if included in the system, may be bid by entering an exclamation point 
(!) at a terminal. 

4.3 LUNOs 

The Control Program assigns LUNO 2 to a pathname given in response to the PROGRAM: prompt 
(i.e., the file or device from which the desired program is to be loaded). 
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4.4 OPERATOR INTERACTION 

The Control Program assists in program loading and execution by printing out or displaying ^-^ 

prompts on the system console, sequentially, as follows: 

PROGRAM 

INPUT 

OUTPUT 

OPTIONS 

The following paragraphs describe the prompts and user responses. 

4.4.1 PROMPT RESPONSES. The Control Program prompts the user to enter the program path- 
name, input pathname, output pathname, and option-selections. The Control Program checks 
each pathname for syntax. If the syntax is not correct, the Control Program will prompt the user 
again. After all of the responses to the prompts are entered, the Control Program loads and/or 
executes the specified program. 

Only one pathname can be entered in response to the PROGRAM: prompt. When the program is to ^ 

be loaded as a privileged task (enabling the task to execute certain supervisor calls), the user must 
enter the pathname followed by a ",P". A task, when not linked with the operating system, can be 
made privileged when it is loaded or by issuing a Make Task Privileged SVC at execution. All tasks 
linked with TX990 are privileged. When the task is loaded, it is assigned task ID 10i6 . 

Should the user desire to execute a task already in memory, the task ID, preceded by a hexadecimal 
sign (» must be entered in response to the PROGRAM: prompt. For example, after the TXEDIT 
utility program has been loaded into memory, it can be reexecuted as follows: 



TXDS V. R. E YY.DDD 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



>10 

DSC:TASK2/SRC 
DSC: SCRATCH/SRC 

(carriage return) 



4.4.1.2 INPUT: Prompt. The operator's response to the INPUT: prompt is used to specify the 
pathname(s) of input information needed by the program during its execution. The operator can 
enter zero to three input pathnames separated by commas. The Control Program will check each 
parameter for syntax. If the syntax is wrong, the Control Program will prompt the user again. The 
user must enter the entire line again. 

4.4.1.3 OUTPUT: Prompt. The operator's response to the OUTPUT: prompt is used to specify the 
pathname for storage of the output information resulting from execution of the program. Up to 
three pathnames (separated by commas) can be entered in response to the OUTPUT: prompt. 

4.4.1.4 OPTIONS: Prompt. The operator's response to the OPTIONS: prompt is used to specify 
the option(s) selected from the total alternative options available for the program which is to be 
loaded and executed. 
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4.4.2 DEFAULT VALUES. Except for the PROGRAM: prompt, default values for the Control 
/^^ Program prompts are determined by the program being executed. 

If the user intends to execute a task already in memory without reloading it, he must enter the task 
ID; no default value is allowed. 

If the user intends to load the program from a device (not a file), the device name must be specified 
(i.e., there is no default value). If a file pathname is entered (see Section I on pathnames), the user 
may leave both the device/volume name and the file extension fields unspecified. 

When a PROGRAM: pathname does not specify the diskette volume name or drive, the Control 
Program starts a search for the file beginning with the diskette drive that is the default-substitute 
defined during system generation. For a standard TI-suppKed system, the default-substitute is DSC. 
If the file is not on the diskette of the first default diskette transport drive, the Control Program 
will concatenate a 2 to DSC and the file search would then proceed to DSC2. In the same manner, 
the search continues to DSC3 and to DSC4. The search is only effective when the diskette 
default-substitute is the main diskette drive and when its device-name identifier is comprised of 
m^ three characters, (i.e., DSC or any other three characters). It should also be noted that whenever the 

user specifies the device-name identifier in response to the PROGRAM: prompt, only the specified 
device (e.g., the specified diskette transport drive) is searched. 

When the user enters only a slash (/) as the extension field in the PROGRAM: prompt pathname, 
the extension will default to SYS and SYS will be substituted into the pathname before any drives 
are searched. If neither the extension nor a slash is entered, the extension is assumed to be blanks. 

4.4.3 SPECIAL KEYBOARD CONTROL KEYS. The special keyboard control keys are described 

,_, as follows: 



jffw^ 



1 . RUB OUT/DELETE LINE/ 
ERASE FIELD 



2. CONTROL H/Back Arrow 



3 . Carriage Return/NE W LINE 



4. ESCAPE/RESET 



Allows the operator to reenter a parameter. 
Pressing the RUB OUT key causes a Hne feed 
followed by a carriage return. The operator may 
then enter the line again. 

Allows the operator to backspace by character 
and correct a typing error. 

Causes TXDS Control Program to terminate if 
the carriage return or NEW LINE was the only 
entry in response to the PROGRAM: prompt, 
otherwise terminates a prompt line entry. 

If an ESCAPE or RESET is entered during a 
print out, the TXDS Control Program 
terminates. 



5. 



& 



Causes a default to be activated when entered as 
the response to the INPUT: or OUTPUT: 
prompts. 

In any prompt line, pressing the & key as the 
first character in the response causes the TXDS 
Control Program to restart with the PROGRAM: 
prompt. 
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7. * When entered after a prompt line entry, in place 

of a carriage return, permits the next prompt ""^ 

line to be entered without being prompted by 
the TXDS Control Program. When a prompt hne 
is terminated with an asterisk (*) followed by a 
carriage return, no more prompts are given and 
default-substitutes are made by the utiHty 
program for those pathnames not entered. The 
experienced user can enter all or several of the 
parameters on one prompt Hne. 

The following examples utilize the asterisk (*) feature in lieu of the INPUT:, OUTPUT:, and 
OPTIONS: prompts: 



Example 1 : 



To load the TXEDIT utiUty program after the TXDS Control Program has been loaded, the 

asterisk (*) is used as presented in the following example: -^ 

TXDS V. R. E YY.DDD 

PROGRAM: DSC:TXEDIT/SYS*DSC:TASK2/SRC*DSC:SCRATCH/SRC* 

(where DSC:TASK2/SRC is the INPUT: pathname; DSC: SCRATCH/SRC is the OUTPUT: 
pathname; and the OPTIONS: entry is provided by the default-substitution specified in the 
TXEDIT utility program.) 



The above can also be entered as follows: 

TXDS V. R. E YY.DDD 

PROGRAM : DSC : TXEDIT/S YS 

INPUT: DSC:TASK2/SRC*DSC:SCRATCH/SRC* 



Example 2: 



y<<»^ 



To load the SYSUTL utility program after the TXDS Control Program has been loaded, the -^ 

asterisk (*) is used as follows: 

TXDS V. R. E YY.DDD 

PROGRAM : : SYSUTL/S YS* * *CF, :TEMP/OB J 

(where the INPUT: and OUTPUT: parameters are null and the OPTIONS: parameter is 
CF,:TEMP/OBJ.) 

NOTE 

1. In the above examples, it is necessary to press the carriage 
return key at the end of the parameter line to cause the 
program to be loaded and executed. 
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If a parameter line ends with an asterisk (*) and a pathname is 
not entered for each prompt, then default substitutes are made 
by the utihty program for those pathnames not entered. 



Example 3: 



The following example utiUzes the comma (,) to cause a default-substitution to be made in the 
OUTPUT: pathname below. 

TXDS V. R. E YY.DDD 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXMIRA/SYS 

:TASK1 

CRT 

M800,X,L 



(where the OUTPUT: pathname defaults to a substitute specified in the TXMIRA Assembler 
^^ utihty program.) 

The following example utilizes both the asterisk (*) and the comma (,) special keyboard controls: 

To load the TXMIRA Assembler utility program after the TXDS Control Program has been 
loaded, the asterisk (*) is used as follows: 

TXDS V. R. E YY.DDD 

PROGRAM: :TXMIRA/SYS*:TASK1 *,CRT*M800,X,L 



(where TASKl is the INPUT: pathname and where the OUTPUT: pathname is the 
default-substitute provided in the TXMIRA Assembler utility program.) 



4.5 ACCESSING PARAMETERS THROUGH THE CONTROL PROGRAM 

The responses to the prompts of the Control Program are entered into a block of memory known as 
COMMON memory. The task which is being loaded and executed then accesses COMMON memory 
for the information contained in these responses. The response-information is stored in the bytes of 
COMMON memory in an organized nammer using the formart presented in table 4-1. The 
y*^ programmer, when coding a user utility program or a user appUcations program, will find it 

necessary to become familiar with the format of COMMON memory. Access to the 
response-information in COMMON memory is provided to the programmer by the use of Get 
COMMON Data supervisor call lOie (see Section 6). Get COMMON Data returns the memory 
address and the byte-size of COMMON to the task. The Control Program can only execute in an 
operating system which was generated with at least 170 bytes of COMMON memory. The user must 
take this into consideration when performing system generation. 

A typical example of an operator's response-entries to the TXDS Control Program's prompts is 
presented below, immediately followed by the hexadecimal and ASCII representation in binary 
code of the operator's response that is placed in the COMMON memory block. 

TXDS V. R. E YY.DDD 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXLINK/ 
:TXTST,/,CS1 
:TXTST2/0BJ,LP 
ITXT,M4000 
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Parameter 
PROGRAM: 



Table 4-1. Byte-Allocation of COMMON Memory 
Byte(s) Explanation 



0-15 



To be coded with the same pathname information that is 
entered in response to a PROGRAM: prompt. 



.^i'sm^ 



NOTE 

The response-entries to the PROGRAM:, INPUT:, and OUTPUT: prompts are 
placed in byte-groups of 16 bytes each. The device name is entered in the first four 
bytes, left-justified, and space-filled with zeros. A colon is placed in the fifth byte if 
the program name is a diskette file name; otherwise a binary zero is placed in the 
fifth byte. The file name is entered in the sixth through twelfth bytes, left-justified, 
and space-filled with binary zeros. A slash is placed in the thirteenth byte when a 
diskette file is to be referenced by the pathname being entered; otherwise a binary 
zero is placed in the thirteenth byte. The extension is placed in the fourteenth 
through sixteenth bytes, left-justified, and space-filled with binary zeros. Whenever 
the device, file, or extension is to be defaulted by the utiUty or the user's task, the 
binary field relating to the device, file, or extension will be space-filled with binary 
zeros. When the total parameter (which includes the device, file, and extension 
fields) is defaulted, a colon (:) is placed in the fifth byte and a slash is placed in the 
thirteenth byte and all the fields become space-filled with binary zeros. 



>«"w™^ 



INPUT: #1 



INPUT: #2 



INPUT: #3 



16-31 



32-47 



48-63 



OUTPUT: #1 64-79 



OUTPUT: #2 80-95 



OUTPUT: #3 96-111 



OPTION: 



112-143 



To be coded with the same pathname information that is 
entered for the first INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the second INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the third INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the first OUTPUT: parameter. 

To be coded with the same pathname information that is 
entered for the second OUTPUT: parameter. 

To be coded with the same pathname information that is 
entered for the third OUTPUT: parameter. 

To be coded with the character-entries that the operator 
entered in response to the OPTIONS: prompt. The charac- 
ters entered in response to the OPTIONS: prompt will be 
copied into 1 12-143. Up to 30 characters can be entered 
and copied into COMMON memory and following the last 
character entered is a binary zero. 



^^^*^ 
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Table 4-1. Byte-Allocation of COMMON Memory (Continued) 



Chaining 
Pathname 



144-159 



Chaining 
Flag 



160 



Batch Mode 
Flag 



Batch 
Error 



161 



162 



Used for the chaining pathname, which is the pathname of 
the next program to be loaded and executed if the chaining 
flag in byte 160 is set to a nonzero number. The chaining 
pathname is initialized so that the first four bytes each have 
a binary zero, the fifth byte has a colon, the sixth through 
twelfth bytes each contain a binary zero, the thirteenth byte 
contains a slash, and the fourteenth through sixteenth bytes 
each contain a binary zero. 

This is the chaining flag byte which is set to a nonzero number 
by a user program or a utility program when it is desired to 
chain from the end of one program to the pathname specified 
in bytes 144-159. The object program which is at the path- 
name specified in bytes 144-159 is then loaded and executed. 
One program (a user's task or TXDS utiHty program) can 
chain to another by setting the chaining flag in memory 
(byte 160), placing the access name (i.e., the chaining path- 
name) for the new program in bytes 144-159 and executing 
an End-of-Program 16i6 supervisor call. The INPUT: 
OUTPUT:, and OPTIONS: prompts can be used as required 
to pass parameters to the new program. 

Set if batch job control stream is in progress. The TXDS 
Control Program loads and executes the object program 
which is in the pathname specified in bytes 131^1^15$ . Sf- IS 



Set when a program terminates in error during a batch 
stream. 



Chaining 
Error 



163 



Chaining Error Flag. Set when the program chained termi- 
nates in error. 



Default 
Print 

Reserved 



164-167 



168-170 



Default system console print device declared at time of system 
generation. 

Reserved for later enhancements. 



/0^^>\ 
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The above responses to the prompts are placed into the COMMON memory block as follows: 



Byte 
Address 

0-15 



16-31 



32-47 



48-63 



64-79 



80-95 



0000 



0000 



0000 



0000 



0000 



0000 



Hexadecimal Representation (Upper Row) 
and ASCII Representation (Lower Row) 



3A54 
: T 


584C 
X L 


494E 

I N 


4B00 
K . 


2F00 

/ . 


3A54 
: T 


5854 
X T 


5354 
S T 


0000 


2F20 

/ UJ 


3A00 


0000 


0000 


0000 


2F00 

/ . 



^""^ 



0000 



0000 



0000 



4353 
C S 


3100 
1 . 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


3A54 
: T 


5854 
X T 


5354 
S T 


3200 

2 . 


2F4F 
/ 


424A 
B J 


4C50 
L P 


0000 


0000 


0000 


0000 


0000 


0000 


0000 



96-111 



112-143 



0000 



4954 
I T 



0000 



5854 
X T 



3A00 



2C40 
, M 



0000 



3430 
4 



0000 



3030 




0000 



oo 



2F00 

/ . 

UNDEFINED 



0000 



""^ 



144-159 



0000 



0000 



2A00 



0000 



0000 



0000 



2F00 



0000 



160 



00 



161 



00 



^^ 



162 



00 



163 



00 



164-167 4C4F 4720 

L G 

168-n 



This assumes that LOG was defined as system 
default print device during system generation. 

Not used. 



y*^^N 
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4.6 ERROR MESSAGES 

Refer to table 4-2 for a list of error messages, the reason for each error, and the recovery method. 

Table 4-2. TXDS Control Program Error Messages 

Reason 

nn represents error code 
listed in error appendix I. 



Error 
nn-BAD PGM LOAD 



-BAD PGM LOAD 
nn-CANT BID TASK 



CANT GET COMMON- 
ABORTED 



Can't find object file. 

nn represents the task state 
code of task lOie listed in 
state code appendix G. 

System was configures without 
COMMON. 



Recovery 

Reenter parameter 

Reenter parameter 
Reenter parameter 



Configure a system 
with 170 bytes of 
common 
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SECTION V 
PROGRAMMING TASKS 
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5.1 INTRODUCTION 

A program that executes under the TX990 operating system is also referred to as a task. The task 
consists of a data division and a procedure division. These divisions may be assembled as a single 
module or as two or more separate modules linked to form a single object module. The structure of 
a task is described in this section. 

This section also includes a description of the programming considerations for writing tasks to be 
executed under TX990, and detailed descriptions of the supervisor calls by which a user task 
requests the support of TX990. Also included is a description of task scheculing. 

5.2 TASK STRUCTURE AND PROGRAMMING 

Logically, a task consists of a data division and a procedure division. Figure 5-1 shows the task 
structure supported by TX990, and the relationship of the first three words of the task to the data 
and procedure divisions. The data division contains the workspaces required by the task and all 
other data structures (tables, supervisor call blocks, buffers, constants, etc.). The procedure division 
contains the executable code for the task. When the task is assembled as a single module, the logical 
division of the task into a data division and a procedure division is optional; however, the task 
should be organized so that the procedure division may be shared with other tasks should it become 
desirable. 



/hW™N 



WORD 
WORD 1 
WORD 2 



INITIAL WP CONTENTS 



INITIAL PC CONTENTS 



END ACTION ADDRESS 



DATA DIVISION 



WORKSPACE 



PROCEDURE DIVISION 



(A)133423 



Figure 5-1. TX990 Task Structure 



5-1 



Digital Systems Division 




946259-9701 



The first three words of the data division contain the addresses of the initial workspace, the 
procedure entry point, and the end action entry point, respectively. The contents of the first word ^"^ 

are placed in the WP register when the task begins execution. The user places the address of the 
initial workspace (16-word memory area accessible as 16 workspace registers) in that word. The 
second word contains the address of the entry point to the procedure division, which is placed in 
the PC when the task begins execution. The third word controls end action. When the value in the 
third word is greater than 15, the value is interpreted as the address of an end action routine, 
described in greater detail in paragraph 5.5. When the value is 15 or less, this value has no 
significance other than to indicate that no end action is to be taken. 

When a procedure division is shared with several data divisions, the shared procedural part is re- 
ferred to as a procedure; and each separate data division, or each unique combination of a data 
division and procedure division, is referred to as a task. Normally, each of the procedure and data 
divisions are separately assembled, and in some cases are independently linked. The only case when 
a procedure and tasks are linked together occurs when each is predefined and linked with TX990 
modules to produce a new TX990 operating system. 

Initial execution of each task, in any case, is indicated by the second word in the task module. ^"""^i 

When tasks and procedures are linked together with the TX990 system modules, each task may 
directly reference labels in the procedure. Therefore, the initial PC (second word) in each task may 
directly reference an address in the procedure. Execution may also begin in the task, and direct 
branches or external references to labelled addresses in the procedure are allowed. However, when 
the tasks are dynamically loaded (tasks loaded which are not linked with the system and residing 
on some input media other than the system disk), TX990 forces initial execution to the entry 
point of the procedure. This entry point is indicated by the end vector assembled into the proce- 
dure. At task installation time (Install Task OCP command), TX990 automatically sets initial 
task execution to begin in the attached procedure. "^^ 

References from the procedure to data within tasks, in all cases, must be indirect. Each task begins 
execution with a unique workspace. Thus, a procedure references a task through pointers in the 
workspace. Indexed or indirect addressing may be used. Procedures, in order to be shared, must 
be reentrant. General requirements for reentrant programming are described in the Model 990 
Computer TMS9900 Microprocessor Assembly Language Programmer's Guide, part number 
943441-9701. 

In addition to dividing a task into data and procedure divisions, the user may make parts of the task 
into overlays, using the Link Editor. TX990 supports the automatic overlay loading capability of ^ 

the Link Editor, as described in the Model 990 Computer Link Editor Reference Manual, part 
number 949617-9701. 

Briefly, to create an overlay ed program the user should assemble each intended overlay as a separate 
module, placing the output from the assemblies into separate files. All calls to overlay modules must 
be Branch and Load Workspace Pointer (BLWP) instructions, with the entry point of the overlay as 
the operand (no indexing or register operand is allowed). Next, the program must be linked, using 
the Link Editor. The user specifies the overlay structure of the problem through various link editor 
commands. The link editor LOAD directive must be used, to notify the Link Editor that automatic 
overlay loading is desired. See the Link Editor Reference Manual for more explanation of overlayed 
programs and usage of the Link Editor. 



^<*«ltev 
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5.3 TASK SCHEDULING 

The task scheduler uses a priority scheme with 1 3 1 levels and maintains a list of active tasks by 
priority level. A task is added to the active list according to its priority in each of the following 
cases: 

• When the task is placed in execution (bid). 

• When the task completes a time slice if the time slice option was selected at SYSGEN 
time. 

• When the task becomes ready for the CPU after being suspended either at the task's 
request or by the TX990 I/O supervisor. 

The 131 priority levels are defined as follows: 



PRIORITY: DESCRIPTION : PRIORITY RANK: 

System functions and tasks Highest 



Real-Time 1 User's real-time monitor and control tasks 



4 



• 



Real-Time 127 User's real-time monitor and control tasks 

1 User's highest priority data processing tasks 

2 User's data processing tasks 

3 User's lowest priority data processing tasks Lowest 



▼ 



The user should not use priority level except for system functions. The real-time priorities are 
designed for user appHcations which monitor and control processes. Normally, the user is expected 
to use these priorities in conjunction with an interrupt handler which will "bid" a real-time task 
which will then perform control using CRU instructions. The remaining priorities (1, 2, 3) are 
designed to satisfy the user's computation, I/O, and data processing applications. 

The scheduler has two features which may be selected at SYSGEN time. These are the time sUce 
option and the task sentry option. 

The task sentry option prevents a task from monopolizing the CPU resource by automatically 
lowering the running priority of the task which becomes compute bound. If this feature is selected 
during system generation, each task which remains in execution beyond the time limit established 
will have its priority lowered by 1 . For example, a priority task will become real-time priority 
1, a real-time priority 127 task will become priority 1, and a priority 3 task will remain at priority 
3. The task's original priority will be restored when it is reactivated after it issues a supervisor call 
which causes it to be suspended. 

A task which issues a do-not-suspend supervisor call (SVC 9) may still have its priority lowered as 
described, but it will not be preempted until the expiration of its do-not-suspend time. 
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(A time slice is a period of execution of a task, beginning when the scheduler passes control to the 

task.) A time slice ends when any of the following occurs: ^"^^ 

• The system preempts the task upon expiration of the maximum time period allowed for a 
time slice. 

• The task executes a supervisor call that suspends the task. 

• The scheduler preempts the task due to a higher priority task becoming ready for the 
CPU. 

When the currently executing task completes a time sHce, the task scheduler passes control to the 
oldest task on the active Ust for the highest priority (0). If there is no task on the active Ust for 
priority 0, the oldest task on the active Ust for the next highest priority receives control. 

If the time slice option is not selected at SYSGEN time, then the task will not be suspended until 
it is preempted or it suspends, provided that the task sentry option is not exercised and the task 
exceeds the task sentry time limit. .^^^ 

The maximum time period allowed for a time shce and the maximum time period allowed for the 
task sentry are parameters which may be specified when the system is generated. 

Task management maintains a state code for each task. The state codes are listed in Appendix G. 

5.4 PREVENTING ACCIDENTAL ALTERATION OR DESTRUCTION OF THE OPERATING 
SYSTEM 

An important consideration in programming user tasks is that the tasks do not interfere with 
the proper operation of the operating system. TX990 executes in either the Model 990/4, the Model 
990/5, or the Model 990/10 Computer. Programming considerations to prevent accidental altera- 
tion or destruction of the operating system are different in each model. 

In the Model 990/10 Computer, user tasks may execute in either the privileged or nonprivileged 
mode. An attempt to execute any of the following assembly instructions (described in the Model 
990 Computer IMS 9900 Microprocessor Assembly Language Programmer's Guide part number 
943441-9701) in the nonprivileged mode will result in a fatal error: 

RSET /^ 

IDLE 

CKOF 

CKON 

LREX 

SBC, when the effective CRU address is EOOie or greater 

SBZ, when the effective CRU address is EOOie or greater 

TB, when the effective CRU address is EOOie or greater 



-^ 



y!«"^^ 
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LDCR, when the effective CRU address is EOOie or greater 

STCR, when the effective CRU address is EOOie or greater 

LIMI 

LMF (only available in computers having map option) 

LDS (only available in computers having map option) 

LDD (only available in computers having map option) 

Although privileged and non-privileged modes are not used in the Model 990/4 Computer and the 
Model 990/5 Computer, the user should generally avoid using the above instructions. If necessary 
the user may execute some of the above instructions with care; however, the system may operate 
improperly or fail to operate. 

Execution of an RSET instruction has unpredictable results. Execution of an IDLE instruction 
places the computer in the Idle mode until an interrupt occurs. The CKOF and CKON instructions 
control the real-time clock, which is used by the system to allot execution times to tasks according 
to the scheduling algorithm. A CKOF instruction must not be executed, and a CKON instruction 
should not be required. Execution of an LREX instruction transfers control of the program that 
controls the programmer panel, stopping system operation. Execution of an LIMI instruction may 
interfere with the system control of interrupts. An LIMI instruction with an operand of inhibits 
all interrupts except for power up and programmer's panel. This instruction is permissible if the user 
reenables interrupts by executing an LIMI instruction having an operand of 1 5 as soon as possible. 
A user task should use the Do Not Suspend supervisor call to inhibit suspension of the task at the 
end of the current time slice rather than an LIMI instruction. Integrity of system time is lost if 
interrupts are not reenabled within 8.3 ms (60-Hz line frequency) or 10 ms (50-Hz line frequency). 
In addition, time critical I/O such as communications or the card reader may be inhibited and data 
lost. 

The operating system uses the higher-order Communications Register Unit (CRU) addresses for 
dedicated purposes. None of the CRU instructions (SBO, SBZ, TB, LDCR, or STCR) should access 
any CRU addresses greater than DFFie . For example, if workspace register 12 contained IBFOie 
as the CRU base address, an SBO instruction with a displacement of 8 results in an effective CRU 
address of EOOi^, ^ dedicated address. Displacements less than 8 would result in valid addresses. 
The same base address in workspace register 1 2 would result in accessing dedicated addresses if an 
STCR instruction to store 8 or more bits were attempted. Refer to the Model 990 Computer 
Assembly Language Programmer's Guide, part number 943441-9701, for details of CRU addressing. 

The user may write routines to perform extended operations (XOP). Since an XOP routine running 
under TX990 in the Model 990/4, 990/5, or 990/10 Computers can execute privileged instructions, 
the same precautions that exist for tasks executing in the privileged mode applies to XOP routines. 
Additional information about programming extended operations is included in Appendix C, entitled 
"User-Supplied Modules". 
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5.5 USER-SPECIFIED END ACTION ROUTINE IN RESPONSE TO FATAL ERRORS 

The user specifies end action by placing the address of an end-action routine in the third word of ^^] 

the user task. When TX990 detects a fatal error and terminates the task abnormally, control 
transfers to the address in the third word unless that word initially contained a value of 1 5 or less. 
This allows the user to supply a routine to perform any required terminating function. 

TX990 places the appropriate error code in the third word of the task after obtaining the end action 
routine address. After performing end action, or when the error is detected and no end action is 
specified, TX990 releases all I/O devices, closes all files, and removes the task from execution. The 
task error codes are Hsted in Appendix H, entitled "Printout of Fatal Task Error Codes and Illegal 
Interrupt Code". 

When a task that has taken end action is to be reexecuted without reloading, the end-action routine 
must restore the end-action-routine address in the third word of the task. 

5.6 CODING SUPERVISOR CALLS AND SUPER\aSOR CALL BLOCKS 

A user task requests support of the operating system by executing a supervisor call, XOP Level 15. 

A supervisor call block contains one or more bytes that define the supervisor call. The first byte of a ^ 

supervisor call block contains the code of the supervisor call. Subsequent bytes are used as described 

for specific supervisor calls, when required. 

The supervisor call may be coded in either of two ways. The first example shows a supervisor call 
coded as an XOP instruction: 

XOP @SCBA,15 Perform extended operation 15, by passing the 

address corresponding to @SCBA to the system. 

Alternatively, a symbol may be defined for supervisor calls using DXOP directive, as follows: 

DXOP SVC, 1 5 Define symbol SVC for extended operation 15. 

Supervisor calls following that directive may use the defined symbol, SVC, in the operation field 
and the address of the supervisor call block in the operand field as follows: 

SVC @SCBA Perform extended operation 1 5 using the supervisor 

call block at address @SCBA. 

Supervisor call blocks are coded using BYTE directives, DATA directives, or both. Some supervisor 
call blocks must be aligned on word boundaries (i.e., they must have even addresses). Use of a 
DATA directive assures word alignment, but a BYTE directive does not perform word alignment. 
The descriptions of supervisor calls in the previous paragraphs identify the supervisor call blocks 
that must be word-aligned. 

The following examples show coding for supervisor call blocks: 

SCBA BYTE > 10,0 Place lOie , the code for a Get Common Data Address 

supervisor call, in a byte at location SCBA. The second 
byte contains 0. 

SCBB DATA >0300,DTBUF Place 03i6 , the code for a Get Date and Time supervisor 

call, in the first byte of a two-word block at location 
SCBB, a word boundary. The second byte of the block ^,,«^ 

contains 0, and the last two bytes contain the address ^ 

corresponding to location DTBUF, a five-word buffer into 
which the function places the date and time. 
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Alternatively, the label for a supervisor call block may be supplied with an EQU directive, as 
follows: 

SCBB EQU $ 

DATA >300, DTBUF Assign label SCBB to current location. Place 03 in the first 

byte of a two-word block and the address corresponding to 
location DTBUF in the second word of the block, as in the 
preceding example. 

The preceding example produces the intended result only if the current location is a word-aligned 
location. When the statements in the example follow a BYTE directive or a TEXT directive the 
location may not be word-aligned, and, if it is not, SCBB will not be the address of the supervisor 
call block. The following example will provide the desired result: 

SCBB EVEN 

DATA >0300, DTBUF If the location is not word-aligned, increment the location 

to a word boundary and assign label SCBB to the result. 
f^. Otherwise, assign label SCBB to the location. Build the 

supervisor call blocks as in the preceding example. 



/(pP™N 
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SECTION VI 
EXECUTIVE SUPERVISOR CALLS 



6.1 INTRODUCTION 

Executive supervisor calls (SVCs) in the TX990 operating system provide the user with the ability 
to control activities/operations in the user program, and to request services from the operating 
system. Table 6-1 shows the executive supervisor calls provided by TX990. 

Table 6-1. Executive Supervisor Calls 

SVC Name Hexadecimal 

SVC Code 

Bid Task 5 

Change Priority 1 1 

Do Not Suspend 9 

Time Delay 2 

Activate Time Delay E 

Unconditional Wait 6 

Activate Suspended Task 7 

End-of-Task 4 

End-of-Program 16 

Get Parameters 17 

Get Own ID 20, 2E 

Make Task Privileged 23 

Convert Binary to Decimal A 

Convert Decimal ASCII to Binary B 

Convert Binary to Hexadecimal ASCII C 

Convert Hexadecimal ASCII to Binary D 

Get Memory 12 

Release Memory 13 

Get System Table 21 

Get COMMON Data 10 

Return COMMON Data 1 B 

Put Data IC 

Get Data ID 

Get Date and Time 3 

Enable or Disable Event Key 3 A 

Initialize Time and Date 3B 
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6.2 TASK CONTROL SUPERVISOR CALLS 

Task control SVCs are used to schedule and control the execution of tasks, 
discussed in the following paragraphs. 



These SVCs are 



6.2.1 BID TASK SUPERVISOR CALL 5i6. Bid Task supervisor call 5i6 activates the specified 
task. The supervisor call block contains three, six, or eight bytes, aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1. Byte 2 contains the task identifier 
assigned to the task being bid. If the task is a linked-in task, the task ID was assigned during system 
generation. In systems supporting multiple dynamic tasks, the ID of a dynamic task is assigned by 
the IT OCP command. In single dynamic task systems, the task identifier of the task in the dynamic 
task area is lOje . Byte 3 is unused. Bytes 4 through 7 may contain parameters to be passed to the 
task. The task obtains the parameters by executing a Get Parameters supervisor call. 

When the system is unable to locate the specified task, it returns a -1 in byte 1 of the supervisor call 
block. Otherwise, the system returns the current task state code in that byte. The task state code 
for a terminated task is 4. Other task state codes are listed in Appendix G. When the task state code 
is not equal to 4, the supervisor call is ignored. 

Bid task call block: 



2 
4 

6 



(A)137478 



5 


ERROR CODE 


TASK ID 


RESERVED 


BID PARAMETER t 


BID PARAMETER 2 



The following are examples or coding for supervisor call blocks for Bid Task calls: 
SCBB DATA >0500,>1000,>4845,>4C50 



SCBA DATA >0500,>1 AOO 



Supervisor call block for a Bid Task call to 
bid task IO16, and pass the ASCII repre- 
sentations of characters HELP to the task. 

Supervisor call block for a Bid Task call to 
bid task lA^e- Undefined data from bytes 
corresponding to bytes 4 through 7 of the 
supervisor call block is passed to the task 
as parameters. 



6.2.2 CHANGE PRIORITY SUPERVISOR CALL llje- Change priority supervisor call II16 
changes the priority of the calling task to a specified value. The supervisor call block contains two 
bytes and does not need to be aligned on a word boundary. Byte contains the code, and byte 1 
contains the new priority value. The valid priority levels are through 3 (0 is usually reserved for 
system tasks), and real-time priority levels are 1 through 127. The real-time priority is selected by 
setting bit of byte 1 to a 1. 

The system returns the previous priority value in byte 1. When the priority level is not valid, the 
previous priority level is not altered, and the system returns >80 in byte 1. 



Change priority call block: 



(A)t37479 



701 



1 1 



16 



PRIORITY 



/ 



'REAL TIME 



/*^^\ 



/**"%. 
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The following is an example of coding for a supervisor call block for a Change Priority call: 

SCBP BYTE >1 1 ,1 Change the priority of the calling task to 1 . 

6.2.3 DO NOT SUSPEND SUPERVISOR CALL 9i6 . Do Not Suspend supervisor call 9,^ prevents 
the calling task from being suspended or preempted by the system CPU scheduler. The task may 
suspend itself by executing an I/O supervisor call, a Time Delay, Wait for I/O, or Unconditional 
Wait supervisor call. The supervisor call block contains two bytes and does not need to be aligned 
on a word boundary. Byte contains the code, and byte 1 contains or a positive number. When 
byte 1 contains 0, the task will not be suspended for 200 ms. When byte 1 contains a number, the 
task will not be suspended for that number of system time units. Suspension of a task may be in- 
hibited for a period from 1 to 255 system time units. 

The length of a system time unit is 50 ms. 





NUMBER OF SYSTEM 
TIME UNITS 



f^^^ Do not suspend call block 

(A)l 37490 

The following is an example of coding for a supervisor call block for a Do Not Suspend call: 

SCBI BYTE 9, 5 Inhibit suspending of calling task for five 

system time units. 

The Do Not Suspend supervisor call should be used instead of an LIMI instruction to inhibit sus- 
0^^ pension of a task. When a task manipulates a data structure that is used by several tasks, the task 

should complete its alterations to the data structure before any of the tasks that use the data 
execute again. The Do Not Suspend supervisor call allows such a task to lock out other tasks while 
changing the data. 

6.2.4 TIME DELAY SUPERVISOR CALL 2^ • Time Delay supervisor call 2^e suspends the calling 
task for a specified time period. The supervisor call block contains four bytes, aligned on a word 
boundary. Byte contains the code, and byte 1 contains zero. Bytes 2 and 3 contain the number 
of system time units during which the task is to be suspended. The range of time-delay-suspension 
periods is from 1 to 32,767 system time units. When a negative number is used, the task is sus- 
^^ pended for 1 system time unit. The system time unit is defined in the preceding paragraph. 



NUMBER OF SYSTEM TIME UNITS TO DELAY 



Time delay call block: ^ 

2 

(A)l 37481 

The following example shows coding for a superv^isor call block for a Time Delay call: 

SCBT DATA >200,40 Suspend the calling task for 40 system time 

units. 

6.2.5 ACTIVATE TIME DELAY TASK SUPERVISOR CALL Ejg. Activate Time Delay Task 
supervisor call Eje activates the specified task if it is in the time delay state. The supervisor call 
block contains three bytes, and need not be aligned on a word boundary. Byte contains the code, 
and the system returns a value in byte 1. Byte 2 contains the task identifier assigned to the task. 

When the system is unable to locate the task in the system, it returns -1 in byte 1 of the supervisor 
call block. Otherwise, the system returns the current task state code in that byte. The task state 
code for a task in time delay is 5. Other task state codes are defined in Appendix G. 
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Activate time delay call block: 



(A)l 37482 





2 



^16 


ERROR CODE 1 


TASK ID 





The following is an example of coding of a supervisor call block for an Active-Time-Delay Task 
call: 

SCBR BYTE >EOO>ia Activate task 13i6 , a task in a time delay. 

6.2.6 UNCONDITIONAL WAIT SUPERVISOR CALL 6^6 . Unconditional Wait supervisor call 
6 16 suspends the calling task indefinitely, unless an Activate Suspended Task supervisor call that 
specifies the task has already been executed. In that case, execution resumes immediately. Other- 
wise, the calling task remains suspended until another task executes an Active Suspended Task 
supervisor call for this task. The supervisor call block consists of a single byte that contains the 
code, and need not be aligned on a word boundary. 



Unconditional Wait call block: o 



(A)l 37483 

The following is an example of coding a supervisor call block for an Unconditional Wait call: 



SCBW BYTE >6 



Suspend the calling task unconditionally. 



6.2.7 ACTIVATE SUSPENDED TASK SUPERVISOR CALL 1^^. Activate Suspended Task 
supervisor call 7 15 activates the specified suspended task. When the specified task has not yet been 
suspended by an Unconditional Wait supervisor call, the effect of this supervisor call is to activate 
the task immediately following execution of an Unconditional Wait supervisor call. The supervisor 
call block consists of three bytes, and need not be aligned on a word boundary. Byte contains the 
code, and the system returns a value in byte 1 . Byte 2 contains the task identifier assigned when the 
task was loaded. 

When the system is unable to locate the task in the system, it returns a -1 in byte 1 of the supervisor 
call block. Otherwise, the system returns the task state code in that byte. The task state code for 
a suspended task is 615 . Other task state codes are defined in Appendix G. 



Activate suspended task call block: 



o 
2 



TASK ID 



ERROR CODE 



(A)l 37484 

The following is an example of coding for a supervisor call block for an Active Suspended Task call: 

SCBS BYTE >7,0,>1 1 Activate task 1 1 ig , previously suspended. 

6.2.8 END OF TASK SUPERVISOR CALL 4i6 . End of Task supervisor call 4i6 closes all LUNOs 
assigned by the task and terminates the task. The supervisor call block consists of a single byte that 
contains the code, and need not be aligned on a word boundary. 



/o^^ 



/<^^v 



-^ 



^ 
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End task call block: 



(A)t 37485 

The following is an example of coding for a supervisor call block for an End-of-Task call: 
SCBE BYTE >4 Terminate calling task normally. 

6.2.9 END OF PROGRAM SUPERVISOR CALL 16i6. End-of-Program supervisor call 16i6 
terminates a task. The supervisor call block consists of a single byte that contains the code, and 
need not be aligned on a word boundary. The function of an End-of-Program call is to close all 
LUNOs assigned by the task, to terminate the task, and to execute the rebid task which is normally 
the TXDS control program. The rebid task is discussed in Appendix J. 



End program call block: 



16, 



16 



n 



yl^™^ 



(A)l 37486 

The following is an example of coding for a supervisor call block for an End of Program call: 

SCBP BYTE >16 Terminate calling task normally. 

6.2.10 GET PARAMETERS SUPERVISOR CALL ITi^. Get Parameters supervisor call 11,^ 
obtains task parameters passed to the task by an EXECUTE OCP command or by a Bid Task 
supervisor call. When a task includes a Get Parameters supervisor call, it must be the first supervisor 
call in the task. The supervisor call block consists of six bytes, aligned on a word boundary. Byte 
contains the code, and byte 1 contains zero. The system places the parameters in bytes 2 through 5, 
in the same order in which they were placed in the EXECUTE command or in the Bid Task call. 



Get parameters call block: 



(A)1 37487 




2 
4 



'^16 


1 


BID PARAMETER 1 


BID PARAMETER 2 



The following is an example of a supervisor call block for a Get Parameter call: 

SCBGDATA >1 700,0,0 Obtain task parameters in two words at location SCBG+2. 

6.2.11 GET OWN ID SUPERVISOR CALL 20i6 and 2Ei6. Get Own ID supervisor call, 20^6 or 
2Ei6, returns the Task ID of the user task in byte 1 of the call block. The call block contains two 
bytes and need not be aligned on a word boundary. Byte contains the code, and byte 1 is the task 
ID returned by the system. 

Get own ID call block: 



2°160R2E,6 


TASK ID 1 






(A)l 37488 

The following are examples of coding of the Get-Own-ID supervisor calls: 

SCBB BYTE >20,0 

or 
SCBB BYTE >2E,0 
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NOTE 

SVC 2O16 is not available on the RX990 or DXIO systems. SVC 
2Ei6 should be used where compatibility is required. 



^ 



6.2.12 MAKE TASK PRIVILEGED SUPERVISOR CALL 23i6 . This supervisor call will make the 
calling task privileged, which allows the task to perform direct disc I/O, to execute a Get System 
Table supervisor call, and to execute privileged instructions on a Model 990/10 computer. The 
supervisor call block contains two bytes and need not be aligned on a word boundary. Byte is the 
code and byte 1 is unused. 

Make task privileged call block: 



(A)i 37439 
The following is an example of the Make Task Privileged supervisor call: 

SCBBBYTE >23,0 



6.3 CODE CONVERSION SUPERVISOR CALLS 

The code conversion group of supervisor calls consist of four supervisor calls that convert the binary 
value in a word to ASCII characters, or a group of ASCII characters to a binary value. The super- 
visor calls are described in the following paragraphs. 

6.3.1 CONVERT BINARY TO DECIMAL ASCII SUPERVISOR CALL A16. Convert Binary to 
Decimal ASCII supervisor call A16 converts the binary value in task workspace register to the 
ASCII representation of the equivalent decimal value. The supervisor call block consists of eight 
bytes, and need not be aligned on a word boundary. Byte contains the code and byte 1 contains 
zero. The system places an ASCII minus sign in byte 2 when the value being converted is negative, 
or a blank in that byte when the value is zero or positive. The converted value is placed in bytes 
3 through 7, right-justified with leading blanks. 



Convert binary to decimal ASCII call block: 



A 



l^o^\v^ ^\^^V^ 



Le^^^iw^ ^rti^ 



u 







S } g ntoi 


■1 


Uwis/^neo^ 



(A) 137490 



O 
2 
4 
6 



A, 6 


? 


U 


*c 1 


SIGN 


CONVERTED 




VAI 


JUE 


r 





The following is an example of coding a supervisor call block for a Convert Binary to Decimal 
ASCII call: 



SCBD BYTE 



>A,0,0,0,0,0,0,0 



Convert value in workspace register to decimal 
ASCII and place the result in the supervisor call 
block. 



,^ 



^ 



The following examples show typical values and the results: 

Register Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 



Byte? 



0001 16 


2O16 


20,6 


20,6 


20,6 


20,6 


31 16 


7FFF,6 


20,6 


33,6 


32.6 


37,6 


36,6 


37,6 


FFFF16 


2D ,6 


20,6 


20,6 


20,6 


20,6 


31,6 



^ 
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6.3.2 CONVERT DECIMAL ASCII TO BINARY SUPERVISOR CALL Bi6. Convert Decimal 
ASCII to Binary supervisor call B15 converts the ASCII characters in bytes 2 through 7 of the super- 
visor call block to a binary value, and places the value in task workspace register 0. The supervisor 
call block consists of eight bytes and need not be aligned on a word boundary. Byte contains the 
code; and the system returns a value in byte 1. The calling task places the sign of the decimal value 
in byte 2, which may be the ASCII representation of +, -, zero, or blank. A - identifies the value as 
negative, and +, blank, or zero identifies the value as zero or positive. The ASCII representations of 
the decimal digits are entered in bytes 3 through 7, right-justified with leading blanks or ASCII 
zeros. When the system is able to perform the complete conversion correctly, it returns a zero in 
byte 1. When one or more of the characters are not valid, or the decimal number is not within the 
range of -32,768 to 32,767, the system is not able to complete the conversion, and returns a value 
of -1 in byte 1. 



r^ 



Convert decimal ASCII to binary call block: 



(A)l 37491 



2 
4 
6 



^16 


RETURNED VALUE 


SIGN 


ASCII 


VALUE 



The following example shows the coding of a supervisor call block for a Convert Decimal ASCII 
to Binary call: 

SCBB BYTE >B,0,'0', ' ', ' ','3','7','8' Convert 378 to its binary equivalent and place the 

result in workspace register 0. 

The following examples show typical ASCII values and results. 

Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Register Byte 1 



2Bi6 
20,6 
30i6 
2Di6 



20i6 
20,6 
33,6 
30,6 



20,6 
20,6 
32,6 
30,6 



20,6 
20,6 
37,6 
30,6 



20,6 

31,6 

36,6 
30,6 



31l6 
41,6 

37,6 

31,6 



0001,6 
Undefined 
7FFF,6 
FFFF,6 





FFi6 





^ CONVERT BINARY TO HEXADECIMAL ASCII SUPERVISOR CALL C,6. Convert 

Binary to Hexadecimal ASCII supervisor call Cig, converts the binary value in task workspace 
register to the ASCII representation of the equivalent hexadecimal value. The supervisor call block 
consists of six bytes, and need not be aligned on a word boundary. Byte contains the code, and 
byte 1 contains zero. The system returns the result in bytes 2 through 5. 



Convert binary to hex ASCII call block: 





(A) 137492 



2 
4 



16 



RETURNED VALUE 
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The following is an example of coding of a supervisor call block for a Convert Binary to Hexadeci- 
mal ASCII call: 

SCBH BYTE >C,0,0,0,0,0 Convert the value in workspace register to hexadecimal 

and place the result in the supervisor call block. 

The following examples show typical values and the results: 
Register Byte 2 Byte 3 Byte 4 Byte 5 



0001 16 


30i6 


30i6 


30i6 


31l6 


7FFFi6 


37,6 


46i6 


46i6 


46,6 


FFFF,6 


46i6 


46i6 


46i6 


46,6 



6.3.4 CONVERT HEXADECIMAL ASCH TO BINARY SUPERVISOR CALL Dig . Convert Hexa- 
decimal ASCII to Binary supervisor call Djg converts the ASCII characters in bytes 2 through 5 of 
the supervisor call block to a binary value, and places the value in task workspace register 0. The 
supervisor call block consists of six bytes, and need not be aligned on a word boundary. Byte con- 
tains the code, and the system returns a value in byte 1. The calling task places the ASCII charac- 
ters representing the hexadecimal digits in bytes 2 through 5. When the system is able to perform 
the complete conversion correctly, it returns a zero in byte 1 . When one or more of the characters is 
not vaUd, the system is not able to complete the conversion, and returns a value of -1 in byte 1. 



Convert hex A: 


5CII to decimal call bk 

(A)1 37493 


3ck: 



2 
4 


"^16 




RETURNED VALUE 1 




ASCII VAUUE 



The following is an example of coding a supervisor call block for a Convert Hexadecimal ASCII to 
Binary call: 

SCBH BYTE >D,0/0','3','F','4' Convert 03F4i6 to binary. 

The following examples show typical ASCII values and results: 

Byte 2 Byte 3 Byte 4 Byte 5 Register Byte 1 



30i6 


30,6 


30,6 


31,6 


0001,6 





30,6 


30,6 


33,6 


4B,6 


Undefined 


FF,6 


37 16 


46,6 


46,6 


46,6 


7FFF,6 





46,6 


46,6 


46,6 


46,6 


FFFF,6 






^ 



^ 



6.4 MEMORY ALLOCATION SUPERVISOR CALLS 

The memory allocation group of supervisor calls consist of five supervisor calls that allow the user 
to access various blocks of memory. These supervisor calls are described in the following paragraphs. 

6.4.1 GET MEMORY SUPERVISOR CALL 12i6. Get Memory supervisor call U^e allocates 
a specified number of contiguous 32-byte blocks to the calling task. Each block is aligned on a 
word boundary. The address of the first byte in the first block is returned in user task workspace 
register 9. The supervisor call block consists of four bytes, aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1 . Bytes 2 and 3 contain the number of 
blocks desired. ""^ 
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The TX990 Operating System allocates memory in the dynamic task space. If the requested 
memory is not available, TX990 returns a -1 in byte 1 of the supervisor call block. 



Get memory call block: 



T2 



T 6 



ERROR CODE 



NUMBER OF 32-BYTE BLOCKS TO GET 



(A)T 37494 

The following is an example of a supemsor call block for a Get Memory call: 

SCBG DATA >1200,16 Allocate 256 words of memory to the calling task and return 

the address of the memory area in workspace register 9. 

6.4.2 RELEASE MEMORY SUPERVISOR CALL 13i6 . The Release Memory supervisor call 13i6 
returns memory to the available pool in the dynamic task area. The calling task places the address of 
the first byte of the first block of memory that would be released in task workspace register 9. The 
supervisor call block consists of four bytes, aligned on a word boundary. Byte contains the code, 
and byte 1 contains zero. Bytes 2 and 3 contain the number of blocks that would be released. 



Release memory call block: 



13l6 



--NBlMbBEEzCrF-Bh-eeifS T0 BE REICETStSED-- 



(A)l 37495 

The following is an example of a supervisor call block for a Release Memory call: 



SCBRDATA > 1300, 16 



Release 256 words of memory starting at the address specified 
in workspace register 9. 



6.4.3 GET SYSTEM TABLE SUPERVISOR CALL 21 le- Get System Table supervisor call 2 lie 
returns to the caller the address of the system table in which pointers to data structures within 
TX990 are located. This call can only be made by a privileged task. The supervisor call block 
contains four bytes, bytes through 3, and must be aligned on a word boundary. Byte contains 
the supervisor-call code; byte 1 is unused; and bytes 2 and 3 are returned by the system and con- 
tain the address of the system table. 

The system table has the following format: 

• Word is a pointer to the system time and date block. The time and date blocks consist 
of five words with the following data: 

year, Julian day, hour, minute, and second. 

Word 1 is a pointer to the first element in the Task-Status-Block (TSB) chain. 

Word 2 is a pointer to the first element in the Physical-Device-Table (PDT) chain. 

Word 3 is a pointer to the first element in the Logical-Device-Table (LDT) chain. 

Word 4 is a pointer to the default disc name. 
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• Word 6 is a pointer to the Device Name Table (DNT). 

• Word^-is a pointer to the first element in the Procedure Status Block (PSB) chain. 



Get system table call block: 



21 



1 6 



RESERVED 



RETURNED ADDRESS 



(A)T 37496 

Coding example: 

SCBB DATA >2 100,0 
with the address of the system table returned in the second word of the call block. 

NOTE 

SVC 21 16 is not supported on the RX990 and DXIO systems. 

6.4.4 GET COMMON DATA ADDRESS SUPERVISOR CALL lO^e. Get Common Data Address 
supervisor call lOig causes the system to return the address of the beginning of the COMMON 
area of memory in task workspace register 9, and the size of the area (in bytes) in task workspace 
register 8. The size of the COMMON area is a system parameter specified at system generation. 
The supervisor call block consists of two bytes and need not be aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1. 

When no intertask common has been specified for the system, the system returns a -1 in byte 1 of 
the supervisor call block. Otherwise, the system returns in that byte. 

Get COMMON call block: 



'°16 


ERROR CODE 



(A)T 37497 

The following is an example of coding a supervisor call block for a Get Common Data Address 
supervisor call: 



SCBGBYTE >10,0 



Supply address and size of common memory in workspace 

register 9 and 8, respectively. 



6.4.5 RETURN COMMON DATA SUPERVISOR CALL IBje- Return Common Data supervisor 
call lBi6 performs no operation in TX990 Operating System. The call is included for compatibility 
with DXIO Operating System. The supervisor call block consists of single byte that contains the 
code, and need not be aligned on a word boundary. 



Return COMMON call block : o 



1B^ 



1 6 



(A)1 37498 

The following is an example of the coding of a supervisor call block for a Return Common Data call: 



SCBR BYTE >1B 



Perform a no-operation. 
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6.5 INTERTASK COMMUNICATION SUPERVISOR CALLS 

The Intertask Communication supervisor calls allow the user to pass messages between tasks. The 
system must include Intertask Communication and buffers for messages specified during system 
generation. 

The Intertask Communication supervisor calls are the Put Data and the Get Data supervisor calls. 
Each call specifies an identifier that corresponds to a queue of data messages. Put Data calls that 
specify a given identifier place the data messages in the queue in the order in which the calls are 
executed. Get Data calls that specify the same identifier retrieve the data messages in the first-in 
first-out sequence. 

Messages are queued in buffers supplied by Buffer Management. The number of buffer pools, the 
sizes of the buffers, and the numbers of buffers in each pool are specified during system generation. 
The number of characters required for a message buffer includes the overhead (eight characters per 
message). When a task executes a Put Data supervisor call to place an 80-character message in a 
buffer, the system requests a buffer at least 88 characters in size. Buffer pools must be specified to 
provide an adequate number of buffers of adequate size to support the Intertask Communication 
supervisor calls in the concurrently executing tasks. 

6.5.1 PUT DATA SUPERVISOR CALL ICie. Put Data supervisor call ICie places a message 
from a specified buffer in the user's task into a queue of data messages. The supervisor call block 
consists of 12 bytes aligned on a word boundary as shown in figure 6-1. Byte contains the code 
and the system places a status code in byte 1 at the completion of the operation. Byte 2 contains 
the Purge flag in the most significant bit. The Purge flag should be set to zero for a Put Data 
supervisor call. Byte 3 contains the identifier, a number less than 255. Bytes 4 and 5 contain the 
address of the buffer that contains the message. Bytes 6 and 7 are not used by the Put Data 
supervisor call. Bytes 8 and 9 contain the number of characters in the message. Bytes 10 and 11 
contain zero. 

The operation places the specified number of characters from the specified buffer into the queue 
corresponding to the identifier. The system returns zero in byte 1 when the operation completes 
successfully, and -1 (FFi^) in byte 1 when memory is not available in a queue for the message. 



/j|ff*S 



RELATIVE 
ADDRESS 



8 
10 






1 


2 


3 


4 


5 


6 


7 


1 2 


3 4 5 


6 


7 


CODE 


STATUS 


P 

























IDENTIFIER 














BUFFER ADDRESS 


MESSAGE LENGTH 


ACTUAL MESSAGE LENGTH 









(a) 137510 



Figure 6-1. Intertask Communication Supervisor Call Block 
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The following is an example of coding for a supervisor call block for a Put Data supervisor call: 



SCBP 



DATA 


>1C00 




BYTE 





FLAGS 


BYTE 


25 


IDENTIFIER 


DATA 


MSGl 


BUFFER ADDRESS 


DATA 





NOT USED 


DATA 


80 


80 CHARACTERS 


DATA 





ZERO REQUIRED 



Place message in buffer at address 
MSGl in queue for identifier 15. 
Message contains 80 characters. 






6.5.2 GET DATA SUPERVISOR CALL IDi^. Get Data supervisor call ID.^ obtains a message 
from a specified queue and places it in the specified buffer in the user's task. The supervisor call 
block consists of 12 bytes aligned on a word boundary as shown in figure 6-1. Byte contains the 
code and the system places a status code in byte 1 at completion of the operation. 

Byte 2 contains the Purge flag in the most significant bit. When the Purge flag is set to 1 , the super- 
visor call deletes all the messages in the specified queue and does not place a message in the 
specified buffer. When the Purge flag is set to 0, the supervisor call performs the normal operation. 
Byte 3 contains the identifier of the queue from which the message is obtained. Bytes 4 and 5 con- 
tain the address of the buffer into which the message is placed. Bytes 6 and 7 contain the maximum 
number of characters to be placed in the buffer. The system places the number of characters 
actually received in bytes 8 and 9 at completion of the operation. Bytes 10 and 11 contain zero. 

When the Purge flag is set to 0, the operation transfers a message from the queue associated with the 
specified identifier to the user's buffer. Messages in the queue are transferred in first-in first-out 
order. The number of characters transferred is the number of characters in the message or the 
number of characters specified in bytes 6 and 7 of the supervisor call block, whichever is less. When 
the Purge flag is set to one, the operation deletes all the messages in the queue associated with the 
specified identifier. The system returns zero as a status code in byte 1 when the operation com- 
pletes successfully. When there is no message in the specified queue, the system returns -1 (FFi^) in 
byte 1. The following is an example of coding for a supervisor call block for a Get Data supervisor 
call: 



SCBG DATA >1D00 GET DATA 

BYTE NORMAL OPERATION 

BYTE 35 IDENTIFIER 

DATA RMSG BUFFER ADDRESS 

DATA 64 64 CHARACTERS 

DATA ACTUAL MESSAGE LENGTH 

DATA ZERO REQUIRED 



Obtain a message up to 64 charac- 
ters in length (or the first 64 char- 
acters of a longer message) from the 
queue for identifier 35 and place 
the message in a buffer at location 
RMSG. 



6.6 DATE AND TIME SUPERVISOR CALLS 3 15 and SBi^. The Date and Time supervisor calls 
allow the user to initialize the date and time and to obtain the date and time. 

The Date and Time supervisor calls are Initialize Date and Time (3Bi6) and Get Date and Time 

(3l6). 

6.6.1 GET DATE AND TIME SUPERVISOR CALL 3^e • Date and Time supervisor call 3,^ returns 
date and time in binary form. The supervisor call block consists of four bytes, aligned on a word 
boundary. Byte contains the code, and byte 1 contains zero. Bytes 2 and 3 contain the addresses 
of a five-word area into which the function places the result. The binary values corresponding to the 
year, day, hour, minute, and second are placed in the first through fifth words of that area, respec- 
tively. 



,^^0m^ 



y'^^ 
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Date and time call block: 

(A)1 37499 

Buffer block: 



(A) 137 500 



o 

2 




2 
4 

6 
8 



BUFFER ADDRESS 



YEAR 



DAY 



HOUR 



MINUTE 



SECOND 



The following is an example of coding for a supervisor call block for a Date and Time call: 

SCBT DATA >300,DAT Place date and time data in a five-word area at location 

DAT. 

6.6.2 INITIALIZE DATE AND TIME SUPERVISOR CALL SBig. This SVC stores the date and 
time information given in the specified block. 

The 4-byte call block has the following format: 






BYTE 



SVC CODE 


ERROR CODE 




2 


DATE/TIME BLOCK ADDRESS 





The SVC code, error code, and reserved bytes have the same use as in preceding SVC descriptions. 
Bytes 2-3 contain the address of a block of data which contains the date and time. The data block 
is a 6-word block of the form: 






BYTE 


2 
4 

6 
8 



YEAR 



DAY IN YEAR 



HOUR (0-23) 



MINUTE 



SECOND 
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Each data word should be a binary value. The following is an example of an Initialize Data and 

Time SVC: ^ 



IDATIM 



BLOCK 



EVEN 






BYTE 


>3B 


SVC CODE 


BYTE 





ERROR CODE 


DATA 


BLOCK 


ADDRESS OF DATA BLOCK 


DATA 


1978 


YEAR (1978) 


DATA 


84 


DAY (MARCH 25) 


DATA 


8 


HOUR (8 A.M.) 


DATA 


3 


MINUTE (8:03) 


DATA 

• 


15 


SECOND (8:03:15) 


• 

SVC 


©IDATIM 





^^ 



6.7 ENABLE OR DISABLE EVENT KEY SUPERVISOR CALL 3Ai6 • The Event Key supervisor 
call (3Ai6) allows a task to enable or disable an event key on a user's terminal. When the event key 
is enabled, a user can cause a task level interrupt to a task defined workspace and program counter 
by striking a DSR defined event key. After the user strikes the event key, control is turned over to 
the task at the new WP and PC at its next activation. The value of the event key will be stored in 
RO, and the conditions (WP, PC, ST) of the task is saved in Rl 3-Rl 5. 

When the user task issues the supervisor call, the luno assigned to the task is mapped to a physical 
device. Only one task can be interrupted for a given device. For example, if two tasks issue a super- 
visor call for the same device, the last task to issue the SVC is the one that will be interrupted. 

The event keys for TX990 are defined as follows: 



^ 



733 ASR, 743 KSR 
911 VDT 
913 VDT 



CONTROL/X 
COMMAND Key 
HELP Key 



The following is a description of the Event Key supervisor call block: 



^ 






>3A 


ERROR CODE 


2 


LUNO 


FLAGS 


4 


WORKSPACE 


6 


PROGRAM COUNTER 


8 


RESERVED 



z^^"*^ 
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Byte Contents 

SVC code: >3 A 

1 Error Codes: 

01 16 - Event Table full 

3 1 16 - Event Task not part of system 

FFi6 — Luno not assigned to terminal device. 

2 Luno: The Logical Unit Number of the terminal 

whose event key is to be enabled or disabled. 

3 Flags: 

Bit 0: If equal to 0, enable event key 

If equal to 1 , disable event key 
Bits 1-7: Reserved and must be zero. 

4 Workspace : \ ^^^^^ j^^y interrupt vectors 
6 Program Counter: ) 

8 Reserved and must be zero. 



/n^^ NOXE 



SVC >3A will not be supported on any other Texas Instruments 
operating systems. 



yjJ^P^S, 



y^^pi^^ 



/t^^^'S. 
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SECTION VII 
DEVICE AND FILE I/O SUPERVISOR CALLS 

7.1 INTRODUCTION 

The TX990 Operating System provides several supervisor calls used for performing I/O to devices 
and files. Supervisor call 00 may be used to perform many general I/O and file management 
operations which apply to many different types of devices and files. Three supervisor calls to 
perform character mode I/O to Video Display Terminals are provided. Also provided are a Wait for 
I/O SVC and two Abort I/O SVCs. Table 7-1 lists the I/O supervisor calls. The following paragraphs 
describe each SVC separately. 

Table 7-1 . I/O Supervisor Calls 

Hexadecimal 
SVC Name SVC Code 

General I/O 00 

TX990 release 1 .0 file management 1 5 

VDT utility lA 

VDT character input 8 

VDT conditional character input 18 
^^^ Wait for I/O 1 

f^ Abort I/O by LUNG F 

Abort I/G by call block 1 E 

NOTE 

SVCs 15, lA, 8, 18, and IE are not fully supported on RX990 
and DXIO systems. See Appendix E for further information. 

f^ 7.2 I/O SUPERVISOR CALL (00) 

The general I/O supervisor call (SVC GO) is used to perform I/O to devices and files, and to perform 
many file manipulation operations. The SVC is programmed by coding the appropriate bytes in the 
call block, as shown in figure 7-1 . 

The coding of the bytes is described below. 

• Byte Coded by user with OOie (for supervisor call OOie ). 

• Byte 1 Error status code returned by TX990. For the list of error status codes, see 

Appendix I - I/O Error Codes. 

• Byte 2 Coded by user with the I/O operations code (described in paragraph 7.2. 1 ). 

• Byte 3 Coded by user with the LUNO number to be associated with the I/O device or 

file to be utihzed for the I/O operation. The LUNO is ignored during Create 
f File, Delete File, Compress File, Unprotect File, Write Protect File, and Delete 

Protect File Operations. 
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. 1 



4 .5 



6 ,7 



20 ,21 



26,27 



32 ,33 



34 ,35 



00i6 


ERROR STATUS 


CODE 


i 


4 


i t 


i 


OPCODE 


LUNO 




BS>^ 


erf/ 


EOF^ 


I^ 


l' 


I^ 


I^ 


I^ 


IN-I^ 


RPV^ 


■ ^ 


1 

Ap2 

1 


L^ 


^■ 


r- 


REQUIRED 
FOR DEVICE 
OR SEQUENTIAL 






DATA BUFFER ADDRESS 


FILE OPE 

5 


:rations 




READ CHARACTER COUNT 


RECORD FILE 
OPERATIONS 

r 




WRITE CHARACTER COUNT 




REPLY BUFFER ADDRESS OR 
LOGICAL RELATIVE RECORD NUMBER 


1 






LOGICAL RELATIVE RECORD NUMBER 


REQU 

f FO 


IRED 
R 

)DES 
9916 


i3 


1^ 


P 


|3 


,3 


I^ 


AC^ 


I^ 


.3 


|3 


I^ 


1 
DATA 
TYPE 


AT TYPE 


OP CC 
90,6- 




LOGICAL RELATIVE RECORD SIZE 


^ 




NOT USED 




PATHNAME POINTER 


r 


NOT USED 






NOT USED 




NOT USED 


1 

ONLY 

NECESSARY 

FOR DXIO 

COMPATIBILITY 


NOT USED 


NOT USED 








NOT USED 




' f 


UTILITY FLAGS 


1 : J 


YSTI 


lM FI 


-AGS 










NOTE 


: z: 


USE 


R FLAGS 










NOTE 3: 



yl^lf^ 



^^ 



BSY = BUSY FLAG 

ERR = ERROR FLAG 

EOF = ENO-OF-FILE FLAG 

I = IGNORED 



INT = INTIATE FLAGS 
RPY = REPLY FLAG 



AP = ACCESS PRIVILEGE 
FLAG 



AC = AUTO-CREATE FLAG 

I = IGNORED 

AT = ALLOCATION TYPE 
(CONTIQJOUS/ 
NONCONTIGUOUS) 



LOCK AND UNLOCK 
FLAG 



COMMUNICATION TIME- 
OUT FLAG 



I = IGNORED 



(B)135908E 



Figure 7-1. Supervisor Call Block for I/O Supervisor Call OOig 



^ 
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^^^^^^^ • Byte 4, bit TX990 places a 1 in the busy bit during an I/O operation. When the task 

f^ codes the Initiate I/O flag to 1 , it must monitor this bit when waiting for 

the I/O to complete. 

• Byte 4, bit 1 TX990 places a 1 in the error bit when the I/O operation terminates in 

error. It is for normal termination. 

• Byte 4, bit 2 The operating system sets this bit to 1 when it detects an end-of-file 

record ; otherwise, it is set to 0. 

• Byte 4, Unused, 
bit 3-7 

NOTE 

Bytes 5 through 15 are ignored by I/O operation codes 90i6 through 
99 

• Byte 5, bit Coded by the user with the initiate I/O flag. When this bit is set to 1, 

the operating system will begin the specified I/O operation and return 
control to the task before the I/O is completed. When this bit is set to 0, 
the operating system will not return control to the task until the I/O 
operation is completed. This bit is useful when buffering I/O. 

• Byte 5, bit 1 Coded by the user with the reply flag. This bit should only be set to 1 
when the I/O operation is a write and the LUNO specifies an interactive 
device. When the bit is set to 1, the specified write will be followed by a 
read, allowing the task to receive a reply from the interactive device. When 
this bit is 1 , byte 12-13 must contain the address of a reply block. A reply 
block is a 3-word block: the first word is coded by the user and must con- 
tain the buffer address that contains the characters entered in reply to the 
write operation; the second word must contain the maximum number of 
characters expected to be entered (usually the size of the reply buffer); 
the third word will be returned by the operating system and will contain 
the number of characters actually entered in reply to the write operation. 

• Byte 5 , bit 2 Ignored by TX990 . 

• Byte 5 , Coded by the user to attain the access privilege, during an open opera- 
^^^ -^"4 tion. These bits are ignored during another operation. 

00 — Exclusive all flag indicating that only one task may open the file 
concurrently. 

10 — Shared flag indicates more than one task may open the file con- 
currently. This bit should only be set when doing an open operation 
to a relative record file. 
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Byte 5, bit 5 Coded by the user to lock or unlock a logical relative record. When set, 

this flag specifies that the logical relative record is to be locked for all "^ 

read operations and unlocked for all rewrite operations. A locked record 

cannot be read or rewritten by any task except the locking task, and then 

the locking task must use the same LUNO. Any task can unlock a record 

using a 4Ai6 I/O operation. When this flag is zero, then current status 

(locked or unlocked) is unchanged. 

Byte 5, bit 6 Coded by the user with the communications timeout flag. See the Com- 
munications manual for more detail. 

Byte 5, bit 7 Not used by TX990. 

Bytes 6-7 The user must code these bytes to contain the starting address of the I/O 

buffer. 

Bytes 8-9 The user must code these bytes when using a read I/O operation code. 

The bytes must contain the maximum number of characters to be read. f^ 

When the record length specified exceeds the maximum number of charac- 
ters that the device or file allows, only the number of characters that 
are supported by the device or file applies. Not used for write operations. 

Bytes 10-11 When a Write I/O operation is used, bytes 10-11 will contain the number 
of characters to be written. When the character count exceeds the maxi- 
mum number of characters for the device or file, the maximum number of 
characters for the device or file applies. When a Read I/O operation is 
used, the operating system will return the actual number of characters -^^^^ 

read in these bytes. ' 

Bytes 12-13 When the user sets the reply flag to 1, these bytes must contain the 
address of the reply block described above. These bytes need not be 
appended to the above bytes if the I/O operations are directed to sequen- 
tial devices or files. 

Bytes 12-15 When the user is doing I/O operations to relative record files, these bytes 
contain the logical record number. The operating system will update 
these bytes after I/O operations. These bytes need not be appended to j^^- 

the above bytes, except when directing I/O to a relative record file. 

Bytes 16-34 Need not be appended to the above bytes except when using I/O opera- 
tion codes 90 16 through 99 ig. 

Bytes 16-17 Utility Flags. 

Bytes 16-17, Need to be zero for DXIO compatibility. TX990 ignores it. 
bit 0-2, 4-5, 7, 9-10 

Bytes 16-17, Need to be one for DXIO compatibility. TX990 ignores it. 
bit 3, 8 
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• Bytes 16-17, User sets to one to request automatic logical file creation. It is set during 
f'^^ bit 6 an assign I/O device or file operation and causes a file to be created during 

an Open I/O operation. 

• Bytes 16-17, For DXl compatibility only, these bits should be coded : 
bit 11-12 

Code Meaning 

00 Normal record image 

01 Blank suppression 

10,11 Reserved for new data formats 

These bits are ignored by TX990. All sequential files are blank suppressed 
under TX990. 

^ • Bytes 16-17, Set to one when creating a noncontiguous file or to a zero when creating 

bit 13 a contiguous file. TX990 will ignore the bit if it is set to zero and will 

create a noncontiguous file without flagging an error. TX990 supports 

only non-contiguous files. This bit is ignored except during create file 

operations. 

• Bytes 16-17, Set to one of the following codes to specify the file type when the file is 
bit 14-15 created. This field is ignored except for create file or assign luno with 

auto-create operations. 

' Code Meaning 

00 undefined 

01 sequential file 

10 relative record file 

1 1 key index file (not supported in TX990) 

• Bytes 18-19 When using create file or assign luno with auto-create operations to create 
a realtive record file, the user must code these bytes with the number of 
characters in each record (i.e., record size). These bytes are ignored when 
creating a sequential file. 

• Bytes 20-2 1 These bytes are not used by TX990. 

• Bytes 22-23 The user must code these two bytes with address of a pathname. These 
bytes are used for Assign LUNO. Create File, Delete File, Change the 
Name, Unprotect File, Write Protect File, Delete Protect I/O operations. 
All other operations ignore this field. The pathname is in the following 
format: 



/P^^K^ 



Count Pathname 

/^^ Byte n Byte 1 -n 
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The first byte at the pathname address is the character count. The follow- 
ing bytes are the pathname itself. 

• Byte 24-35 Need only be appended for DXIO compatibility. 

7.2.1. I/O OPERATIONS. The I/O SVC may be used to perform all of the operations listed in 
Table 7-2, by coding the correct I/O opcode in byte 2 of the call block, and correctly defining the 
remaining fields in the call block. The opcode for each operation is given in the table. 

Table 7-2. SVC 00 I/O Operations 



/<«!«W^ 



Operation 

Open 

Close 

Close with end-of-file 

Open with rewind 

Close and unload 

Read device status 

Forward space 

Backward space 

Read ASCII 

Read direct 

Write ASCII 

Write direct 

Write end-of-file 

Rewind 

Unload 

Unlock 

Create file 

Assign LUNO to pathname 

Delete file 

Release LUNO assignment 

Compress file 

Assign new file name 

Unprotect file 

Write protect file 

Delete protect file 

Verify pathname 



Hexadecimal 
Opcode 

00 

01 

02 

03 

04 

05 

06 

07 

09 

OA 

OB 

OC 

OD 

OE 

OF 

4A 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 



.yf^m^ 



NOTE 



Most of the "ninety" opcodes do not apply to device operations 
(exceptions are Assign and Release LUNO). Table 7-3 shows which 
of the other operations apply to which devices. 

The following paragraphs describe each operation in detail. 

7.2.2 OPEN OPERATION (CODE 00i6). The Open operation is specified by placing code 00 16 in 
byte 2 of supervisor call block. A description of how the Open operation controls the I/O device 
and the file on the medium of the I/O device is presented in the following subparagraphs. 
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^^ 7.2.2.1 Controlling the I/O Device. When a device is designated during system generation to be in 

(^ the file mode (i.e., available to be utilized by only one program), the open operation causes the 

device to be assigned solely to the calling program until a close operation (i.e.. Close, Close with 
EOF, or Close Unload is executed. In addition, when a device is designated during system genera- 
tion to be in the file mode, an open operation (i.e.. Open or Open Rewind) must be performed be- 
fore any other file management operation is executed. Until an open operation is executed, files on 
diskettes are not located and file management operations to manipulate them cannot be initiated or 
performed. 

The following device operation(s) result from execution of an open operation: 

• Dummy No operation. 

• 91 1 or 913 VDT Performs a line feed and a carriage return. 



.m^\ 



n 



i^^*S 






733 ASR Keyboard/ Performs a line feed and a carriage return. 
Printer, KSR, or 820 

• 33 ASR Teletype Performs a line feed and a carriage return. 
Keyboard /Printer 

• 33 ASR Teletype Two bells are output and a RUB OUT key must be entered. 
Paper Tape Punch, 

and Reader 

• Other devices No operation. 

When a device responds to an open operation, the operating system returns the device code 
number (table 7-3) to bytes 6 and 7 of the supervisor call block, which bytes are usually used for 
data buffer address field. 

7.2.2.2 Controlling the Diskette File. When a relative record file is to be exclusively accessed, the 
shared access flag in byte 5 of the supervisor call block, for the open operation, must be set to zero. 
Sequential files are always exclusively accessed. The file then remains assigned to the program until 
the program is terminated or until a close operation is executed. In response to an open operation 
to a file, the operating system returns the file code number (table 7-4) to bytes 6 and 7 of the 
supervisor call block (which bytes are usually used for the data buffer address), code OIFF16 to 
indicate that a sequential file has been opened or code 02FFi6 to indicate that a relative record file 
has been opened. When the auto create flag is set during the assign LUNO to pathname operation, 
the open operation causes a file to be created if the file does not already exist. When a relative 
record file is opened, the record size is returned in bytes 8-9 of the call block. 

7.2.3 CLOSE OPERATION (CODE 01 16 ). The close operation is specified by placing code 01 15 in 
byte 2 of File Management Supervisor Call Block OOig. When specified by the user, the close opera- 
tion releases the I/O device and the file on the medium of the I/O device from the calhng task. 
When a task assigns more than one LUNO to an I/O device and opens them, a close operation 
should be executed for all LUNOs for which an open operation was performed. When a close 
operation is executed to a diskette file, the file is released from the task and any records locked 
by the task are released. When I/O device is designated to be in the file mode during system 
generation, a close operation (or close with EOF or close unload) must be executed to release 
the file from the calling task. 
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I/O Code/Operation 
(Hexadecimal) 



00,6 
OPEN 



Table 7-3. I/O Operations (Record Mode) 



733 ASR/KSR 
or 743 KSR 



Card Line 



733 ASR 



913/911 
VDT 



Dummy 



33 ASR 



Keyboard/Printer Reader Printer Cassette Units (Record Mode) Device Keyboard/Printer Punch 



33 ASR 33 ASR 

Reader 

R 



979A 
Magnetic 
Tape Unit 

R 



01.. 
CLOSE 



02,, 



CLOSE-WRITE EOF 

03,e 
OPEN-REWIND 

04., 
CLOSE-UNLOAD 

05„ 

READ DEVICE STATUS 



06,, 

FORWARD SPACE 


I 


I 


07,e 

BACKWARD SPACE 


I 


' 


09„ 

READ ASCII 


R 


R 


OA,, 

READ DIRECT 


E 


R 


OB.e 

WRITE ASCII 


R 


E 


oc., 

WRITE DIRECT 


E 


E 


OD,, 
WRITE EOF 


R 


E 


OE., 
REWIND 


I 


' 


OF-.e 
UNLOAD 


I 


' 


4A,, 
UNLOCK 


E 


E 


Note: Unlock I/O operation used for relative record diskette files. 


R - Response 
I - Ignored 
E - Error 







^ 



^^•'^^ 



^ 
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Table 7-4. Device Code Numbers and File Code Numbers 
Device/File Name Device Code Number File Code Number 

Dummy 0000 

743 KSR or 733 ASR/KSR Keyboard/Printer 0001 

Line Printer 0002 

733 ASR Cassette Unit 0003 

Card Reader 0004 

911 or 913 Video Display Terminal 0005 

33 ASR Keyboard/Printer 0001 

33 ASR Paper Tape Punch 0003 

33 ASR Paper Tape Reader 0003 

Diskette 0006 

Communication Device 0007 

979A Magnetic Tape Unit 0008 

Sequential Record File OIFF16 

Relative Record File 02FFi6 

No physical device operation(s) results from execution of a close operation. 

7.2.4 CLOSE WITH EOF OPERATION (CODE 02i6). The close with EOF operation is specified 
by I/O operation code 02 15 . The operation consists of the close operation previously described 
and a write EOF operation for the specified device. When the device specified is the keyboard/ 
printer, the printer performs three line-feed operations. When the device specified is the line printer, 
the printer performs a form-feed operation. When the device specified is the 91 1 or 913 VDT, only 
the close operation is performed. The close with EOF operation is an illegal operation for the card 
reader and the system returns the appropriate error status code. When the device specified is the 
paper-tape punch, an ASCII EOF is punched (DC3, CR, LF, DCS, null, null, null, null) and 80 null 
frames are punched for trailer. If a close with EOF operation is executed to a diskette file, the cur- 
rent position of the file is stored as the end-of-file. The close with EOF operation for relative record 
writes the end-of-file to the record number in bytes 12 through 15 of the SCB. 

7.2.5 OPEN REWIND OPERATION (CODE 03 1 J. The open rewind operation is specified by I/O 
operation code 03 jg- The operation consists of an open operation previously described, and a 
rewind operation. When the device is the line printer, the device performs a formfeed operation. 
When the device is a VDT, the system blanks the screen and positions the cursor on column of 
the last row, the home position. When the device is a cassette unit, the device rewinds the cassette 
and places it in the ready state. When the device is the keyboard/printer or the card reader, only 
the open operation is performed. 

When the paper-tape punch is opened with rewind, two bells are output and the user then turns 
on the punch and presses the RUB OUT key. When the RUB OUT key has been pressed then 80 
null frames are punched for leader. For a sequential diskette file, the current record is the first 
record in the file, and for a relative record file, the record number in the SCB is set to zero. 

7.2.6 CLOSE UNLOAD OPERATION (CODE 04i6). The close unload operation is specified by 
I/O operation code 04i6 . This operation consists of a close operation previously described, and an 
unload operation. When the device is the line printer, the device performs a form-feed operation. 
When the device is a cassette unit, the device rewinds the cassette to the clear area at the beginning 
of the tape. When the device is a keyboard/printer or the card reader, only the close operation 
is performed. 
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When the device is the 33 ASR paper-tape punch, 80 null frames are punched. A close unload 

operation to a diskette file causes the file to be closed. ^"^ 

7.2.7 READ DEVICE FILE STATUS OPERATION (CODE 05 le). The read device-file status 
operation is specified by I/O operation code 05 15. The operation is ignored by all devices except 
the 33 ASR, the magnetic tape unit, and diskette files. 

When the device is the 33 ASR, the read character count (bytes 8 and 9) is cleared. 

The Read Device Status operation returns two bytes of status information as follov^s for Magnetic 
Tape Units: 

First Byte: 80 16 — Tape unit on-line, write ring installed. 

40 16 — Tape unit on-line, no write ring installed. 
2O16 — Tape unit off-line. 

Second Byte: 8O16 - Phase encoded recording, 1600 bits per inch (bpi). 

00 — Non-return to zero inverted (NRZI) recording, 800 bpi. -^ 

When the device-file is a diskette file, file characteristics and format are stored in the user's buffer 
address, which is specified by bytes 6, 7 of the supervisor call block. The buffer must contain 3 
words. The operating system will return a in word 1. Word 2 will contain the logical record 
length when file is a relative record file; otherwise it will contain a zero. Word 3 will contain the 
physical record length and will be 128. 



7.2.8 FORWARD SPACE OPERATION (CODE 0615). The forward space operation is specified 
by I/O operation code O616. The operation is ignored by all devices except the 733 ASR cassette 
and the magnetic tape units. The operation moves the tape forward a specified number of records 
or unit an end-of-file record is read. The number of records to be read is placed in bytes 10 and 1 1 
of the supervisor call block. When an end-of-file record is read, the tape is positioned at the beginn- 
ing of the record following the end-of-file. 

The forward space operation causes a diskette file to skip records in the forward direction. Bytes 
10 and 1 1 of the Supervisor Call Block (SCB) contain the number of records to be skipped. For a 
relative record file, file management updates the record number in the SCB. If an end-of-file occurs 
before the specified number of records has been skipped, the end-of-file flag in the SCB is set, 
and the operation stops. The next operation accesses the first record following the end-of-file. 
Following the operation, bytes 10 and 1 1 of the supervisor call block contain the number of records 
remaining to be skipped; zero when an end-of-file did not occur. 

7.2.9 BACKWARD SPACE OPERATION (CODE 07i6). The backward space operation is spec- 
ified by I/O operation code 07i6. The operation is ignored by all devices except the 733 ASR 
cassette and the magnetic tape units. The operation moves the tape a specified number of records in 
the reverse direction. Bytes 10 and 11 of the Supervisor Call Block (SCB) contain the number of 
records to be moved. The backward space operation causes a diskette file to skip records in the 
reverse direction. The number of records to be skipped is placed in bytes 10 and 11 of the SCB. 
For a relative record file, file management updates the record number in the SCB. For a sequential 
file, if an end-of-file occurs before the specified number of records has been skipped, the operation 
stops. The next operation accesses the first record after the EOF. Following the operation, bytes 
10 and 1 1 of the SCB contain the number of records remaining to be skipped; zero when an end- 
of-file did not occur. 



^ 



^ 
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7.2.10 READ ASCII OPERATION (CODE 09i6). The read ASCII operation, code 09i6, reads a 
{ record of the specified file and stores the data, packed two characters per word in the buffer at 

the address in bytes 6 and 7 of the Supervisor Call Block (SCB). The maximum number of char- 
acters in the buffer is placed in bytes 8 and 9 of the SCB. The actual number of characters stored is 
placed in bytes 10 and 1 1 of the SCB. This number will be the number of characters in the record 
or the value in bytes 8 and 9, whichever is less. If an end-of-file occurs, file management sets the 
EOF bit in the SCB and sets the character count in bytes 10 and 1 1 of the SCB to zero. When the 
file is a relative record file and no end-of-file was encountered and the read operation is successful, 
file management increments the record number in bytes 12 through 15 of the SCB. 

NOTE 

The ASCII characters listed for each device in Appendix B are the 
valid characters for that device, and are stored with the most signifi- 
cant bit set to zero. Except as noted for the card reader, other 
characters are ignored. When the device specified is a Magnetic Tape 
Unit, the Read ASCII operation reads the current record and trans- 
(^^ fers the available characters to the specified buffer in memory. 

When the device specified is a VDT, the operation sounds a tone to request the user to enter the 
characters at the keyboard. Characters are transferred to a buffer until the user enters a carriage 
return (New Line on a 913 VDT) or the number of characters specified in bytes 8-9 are entered. 
A carriage return is not included in the character count. If only a carriage return is entered, a zero 
is returned in the character count word in the SCB. When the device is the keyboard/printer, the 
user may correct the most recently-entered character by entering a backspace (CTRL/H). The 
^^ character is deleted, and the printer performs a backspace and a line feed operation. When the 

f^ device is a VDT, the most-recently entered character may be corrected by entering the left arrow 

(<-), which deletes the character in the buffer and backspaces the cursor. 

When the device specified is a 733 ASR cassette unit, the operation transfers characters from the 
cassette to the specified buffer until an end-of-record is detected or the number of characters 
specified in bytes 8-9 are read. The maximum number of characters in a cassette record is 83. 
When the number of characters to be read is less than the number of characters in the record, 
the remaining characters in the record are not available. An end-of-file record on the cassette 
is a record having a DC3 (X-OFF) character as the first character. The cassette unit does not pro- 
^ vide a logical end-of-medium indication, but does provide a physical end-of-tape indication. The 

physical end-of-tape indication may indicate either end of the tape. 

When the device specified is a card reader, the operation reads a card and transfers the characters 
read to the specified buffer. The number of characters specified is transferred up to a maximum of 
80 characters. When the number of characters specified is greater than 80, only 80 characters are 
read and transferred. When fewer than 80 characters are specified, the remaining characters on 
the card are not available. Characters other than those hsted in Appendix B for the card reader are 
placed in the buffer as spaces, and the system returns an error status code when these characters 
are read. The end-of-file record for the card reader has a slash in the first column and an asterisk 
in the second column (/*). 

The read ASCII operation is an illegal operation for the line printer, and the system returns an 
error status code. 
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When the device specified is the cassette unit, the system sets the most significant bit of each ^^^^^^^^ 

character to zero and stores the characters two per word. The read operation terminates when a "^^ 

complete physical record has been read. When the device specified is a Magnetic Tape Unit, the 
Read Direct operation is the same as the Read ASCII (09 je) operation. 

7.2.11 READ DIRECT OPERATION (CODE 0Ai6 ). The read direct operation is specified by I/O 
operation code 0Ai6 . The operation reads the number of characters specified as the record length 
in bytes 8 and 9 of the Supervisor Call Block (SCB). The operation transfers the characters to the 
buffer at the address in bytes 6 and 7 of the SCB without any characters translation and places the 
number of characters read in bytes 1 and 1 1 of the SCB. 

When the device specified is the cassette unit, the system sets the most significant bit of each 
character to zero and stores the characters two per word. The read operation terminates when a 
complete physical record has been read. When the device specified is a Magnetic Tape Unit, the 
Read Direct operation is the same as the Read ASCII (09 15) operation. 

When the device specified is the card reader, a column on the card is stored in a word of the buffer. 
The four most significant bits of the word are set to zero; the holes in the card are stored as ones, in ^""^ 

the order shown in figure 7-2. The entire record is transferred to the buffer, and the end-of-file 
record is underfined for a read direct operation. 

When the device specified is the 33 ASR paper-tape reader, each frame contains one byte of 
information in ASCII format. 

A diskette file read direct operation is identical to the read ASCII operation for a diskette file. 

When the device is a 733, 743, or 820 keyboard/printer, the least significant 7 bits of each input 
character are stored in the buffer. An input carriage return character terminates the I/O and is 
not stored in the buffer. 

When a read direct operation is attempted on the other devices, the system returns an error status 
code. 

7.2.12 WRITE ASCII OPERATION (CODE OBie). The write ASCII operation, code OB^e, trans- 
fers the data in the buffer at the address in bytes 5 and 7 of the Supervisor Call Block (SCB) to 
the specified file. The characters in the buffer are packed two per word. Bytes 10 and 1 1 of the SCB 
contain the number of characters to be written. When the file is a relative record file and the write . ^ 
operation is successful, file management increments the record number in bytes 12 through 15 of 
the SCB. A write ASCII operation clears any end-of-file indication for the current record or for a 
subsequent record. 

NOTE 

Each device recognizes the characters Usted for the device in Appen- 
dix B. Other characters are ignored. 



^ 
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Figure 7-2. Bit Manipulation for Direct Read of Card 

When the device specified is a Magnetic Tape Unit, the Write ASCII operation transfers data from 
the specified user buffer and writes the available characters to tape. 

When the device specified is the keyboard/printer, the characters are printed. An HT character 
results in a space, and an FF character results in eight Hne feed operations. When the device 
specified is the line printer, the characters are also printed. Model 306 and Model 588 Line Printers 
recognize the SOCOEjg) character as specifying a line of elongated characters. The SO character 
should be the first character of the line, and causes the printer to print double-width characters on 
the entire line. The number of characters per line is one-half the normal number of characters; i.e., 
40 characters per 80-character line, or 66 characters per 132-character line. 

When the device specified is a cassette unit, the characters are written on the cassette. A carriage 
return in the buffer is translated to an ETB (11 le) character. The maximum number of characters 
to be written is 83. When the buffer has been written, the system then writes a carriage return, a 
line feed, a DC4 (record off) character, and a DEL (rub out) character to indicate an end of 
physical record. When the reply bit is set, the response is read from the other cassette unit. 

When a write ASCII operation is attempted on the card reader, the system returns an error status 
byte. 

When the device specified is the 33 ASR paper-tape punch, characters are written a byte at a time 
in the ASCII format. A carriage return in the buffer is translated to an ETB (11 le) character. The 
system punches an ASCII end-of-record (CR, LF, DC3, null, null, null, null) when the buffer is 
exhausted. When a write ASCII operation is attempted on the 33 ASR paper-tape reader, the system 
returns an error status byte. 
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7.2.13 WRITE DIRECT OPERATION (CODE OCig). The write direct operation is specified by 
the I/O operation code OCie- The operation writes a record without performing any translation, 
writing the characters from the buffer at the address in bytes 6 and 7 of the Supervisor Call Block 
(SCB). The number of characters to be written is specified in bytes 10 and 1 1 of the SCB. 

When the device specified is the cassette unit, the seven least significant bits of each byte are written 
on the cassette. The maximum number of characters per record is 83. If a DC4 character is 
embedded in the buffer, the system writes the character and also a DC2 (record on) to continue 
the operation. To assure that the last record is actually written on the tape, the user task should 
place a carriage return in the buffer. When the reply bit is set, the response is read on the other 
cassette unit. When the device specified is a Magnetic Tape Unit, the Write Direct operation is the 
same as the Write ASCII (OBie) operation. 

When the device specified is the 33 ASK paper-tape punch, all eight bits of each byte are punched 
on the paper tape. If a DC4 (14i6) character is embedded in the buffer, the system punches the 
character and also a DC2 (record on, 12i6) to continue the operation. The system punches an 
end-of-record (DC3, null, null, null) when the buffer is exhausted. 

When the device specified is a line printer, the seven least significant bits are sent to the printer and 
the installed options will determine how the characters are interpreted. 

A diskette file write direct operation is identical to the write ASCII operation for a file. 

When the device is a 733, 743, or 820 keyboard/printer, all eight bits of every character in the 
buffer are transmitted to the device. 

When the write direct operation is attempted on any other device, the system returns an error .-^^ 

status code. 

7.2.14 WRITE EOF OPERATION (CODE ODie). The write EOF operation is specified by I/O 
operation code 0Di6. The operation consists of writing the end-of-file record defined for the 
specified device. When the device is a Magnetic Tape Unit, the operation writes the Magnetic Tape 
EOF mark. 

When the device specified is the cassette unit, the operation writes a DC3 (X-OFF) character on 
the cassette. When the device is the keyboard/printer, the operation performs three line-feed 
operations. When the device is the line printer, the operation performs a form-feed operation. When '^ 

the device is the VDT, the operation is ignored. When the device is the card reader, the system 
returns an error status code, and no operation is performed. 

When the device specified is a 33 ASR paper-tape punch, an ASCII end-of-file is punched. 

When the unit specified is a diskette file, the write EOF operation writes the end-of-file record. 
There is no limit to the number of end-of-file records that may be written to a sequential file but 
there may be only one for relative record files. For a relative record file the end-of-file is written in 
the record specified (bytes 12-15 of the supervisor call block). 

7.2.15 REWIND OPERATION (CODE OEi^). The rewind operation is specified by I/O operation 
code 0Ei6 . When the device specified is the cassette unit, the operation rewinds the cassette tape to 
the clear area at the beginning of the tape, and then moves the tape in the forward direction to the 
beginning of tape marker, illuminating the READY indicator on the 733 ASR. When the specified 
device is the line printer, the operation performs a form feed operation. When the device is a Magne- 
tic Tape Unit, the operation rewinds the tape to the load point and places the unit in the ready ^^^ 
state. 
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A diskette file rewind operation simulates the rewinding of a cassette file, causing the next read 
f^^ or write operation performed on the file to access the first record in the file (not a subfile). After 

a sequential file has been opened and records written to it, the file cannot be rewound until an 
EOF mark is written or the file is closed. When the file is a relative record file, file management 
places a zero in bytes 12-15 (logical relative record number) of the supervisor call block. 

The rewind operation is ignored by other devices. 

7.2.16 UNLOAD OPERATION (CODE OFie). The unload operation is specified by operation 
code OF 16. The operation is ignored by all devices and files except the cassette and magnetic tape 
unit. The unload operation for the cassette unit consists of rewinding the cassette tape to the clear 
area at the beginning of the tape. For the magnetic tape unit, the operation consists of rewinding 
the tape to the physical beginning in preparation for unloading the reel. 

7.2.17 UNLOCK OPERATION (CODE 4Ai6). The unlock operation, code 4Ai6, unlocks a 
relative record file record that has been locked by a previous read. The record to be unlocked is 

^^ specified in bytes 12 through 15 of the supervisor call block. 

7.2.18 CREATE FILE OPERATION (CODE 90i6). The create file operation is specified by 
placing code 90i6 in byte 2 of file management supervisor call 00i6. To create a file, code utility 
flag byte 16, logical relative record size bytes 18 and 19, and pathname pointer byte 22. Bytes 5 
through 15 are ignored. 

7.2.19 ASSIGN LUNO TO PATHNAME OPERATION (CODE 91 le). The assign LUNO to 
pathname operation is specified by placing code 91 16 in byte 2 of the Supervisor Call Block (SCB). 
The user must code byte 3 of the SCB with the LUNG, and byte 22-23 with the pathname pointer 

f^^' to the file or device. When the user sets the auto-create bit 6 of bytes 16-17 to a 1 , the user must 

also code bits 11-15 of bytes 16-17 and bytes 18, 19 of the SCB. If the diskette file does not al- 
ready exist it will be created when an open operation is executed using the LUNO in byte 3. 
Diskette files are not located by file management until they are opened, therefore the user may 
assign LUNOs to diskette files before the diskette which contains the file is actually loaded. Unlike 
diskette files, devices are located when the LUNO is assigned. Bytes 5 through 15 are ignored. 

7.2.20 DELETE FILE OPERATION (CODE 92i6). The delete file operation is specified by 
placing code 92 le in byte 2 of the Supervisor Call Block (SCB). The file identified by the pathname 

f^^ specified in bytes 22 and 23 is deleted when this operation is executed. When the file to be deleted 

does not exist, an error is returned. Bytes 5 through 21 are ignored. 

7.2.21 RELEASE LUNO ASSIGNMENT OPERATION (CODE 93 15). The release LUNO assign- 
ment operation is specified by placing code 93 16 in byte 2 of the Supervisor Call Block (SCB). The 
user must code byte 3 with the LUNO number which is to be released from its previously assigned 
pathname. Bytes 5 through 23 are ignored. 

7.2.22 COMPRESS FILE OPERATION (CODE 94i6). The compress file operation is specified 
by placing 94 16 in byte 2 of the Supervisor Call Block (SCB). The user must also code bytes 22-23 
of the SCB with the pathname pointer to the file that is to be compressed. It is beneficial to com- 
press files that have contained a large number of records and then rewritten so they contain fewer 
records than the original file. The compress operation will return the unused allocation units be- 
yond the end-of-file which are not being used by the current file. Bytes 5 through 21 are ignored. 
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7.2.23 CHANGE FILE NAME (CODE 95i6). The user must code bytes 22 and 23 with the 
pointer to the new pathname and code byte 3 with the LUNO which must be previously assigned 
to the old file pathname which is to be changed. Bytes 5 through 21 are ignored. 
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7.2.24 UNPROTECT FILE OPERATION (CODE 96,6). The user must code bytes 22-23 with 
the pathname pomter to the file that is to be unprotected. If the file is already opened using an 
open I/O device-file operation, the file will not be unprotected until the file is closed. Bytes 5 
through 21 are ignored. 

7.2.25 WRITE PROTECT FILE OPERATION (CODE 97,6 ). The user must codes bytes 22-23 of 
the supervisor call block with the pathname pointer to the file that is to be write protected. If the 
file is already opened, the file will not be write protected until the file is closed. Bytes 5 through 21 
are ignored. 

7.2.26 DELETE PROTECT FILE OPERATION (CODE 98,6 ). The user must codes bytes 22-23 
of the supervisor call block with the pathname pointer to the file that is to be delete protected. 
If the file is already opened, the file will not be deleted protected until the file is closed. Delete 
protected files are also write protected. Bytes 5 through 21 are ignored. 



7.2.27 VERIFY PATHNAME SYNTAX (CODE 99,6). The user must code bytes 22-23 of the 
supervisor call block with the pathname pointer to the pathname that is to be verified. If the syntax 
is correct, the error status byte will be 0, otherwise it will contain an error code. See error code 
Appendix I. ' 

7.2.28 CODING EXAMPLES USING FILE MANAGEMENT SUPERVISOR CALL 00,6 . The 

following is a coding example for a supervisor call block that will write a record to LUNO 8. LUNO 
8 must have been previously assigned to an interactive device. The reply flag is set to 1 indicating 
that a read will follow the write. 



"•^ 



SCBO 



DATA 
BYTE 
DATA 





>0B,8 

>0040 



DATA OBUFF 



DATA 
DATA 




80 



DATA RBLK 
An example of a reply block is as follows: 
RBLK 



DATA 


RBUFF 


DATA 


40 


DATA 






Write a record to LUNO 8 

The flag word of the SCB indicates that this will 

be an output with reply. 
The record will be written from the memory 

buffer OBUFF. 

80 characters will be written from the memory 

buffer. 
The reply control block is located at RBLK. 



Place the reply in the memory buffer RBUFF. 
Input up to 40 characters. 

The number of characters actually inputed will 
be returned by the system in this data word. 



^ 



/-^ap^ 



7-16 



Digital Systems Division 




946259-9701 



/«^*S\ 



The following example shows how File Utility Supervisor Call 00 15 assigns LUNO 6 to the diskette 
file DSC:TEXT/SRC. If the file does not already exist it will be created when an OPEN operation 
is performed on LUNO 6. 



4^^\ 



SVCBLK EVEN 
BYTE 
BYTE 
BSS 
DATA 

DATA 
DATA 
DATA 

BSS 

PATHNM BYTE 
TEXT 



>00,>00 
>91,>06 

12 
>1285 



PATHNM 

12 

16 

DSC :TEXT 



Assign LUNO 6 to a file. 

Set the auto-create flag to create a noncontiguous 
sequential file. 



PATHNM refers to a memory buffer that has the 
ASCII representation of the file pathname. 



/SRC 
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The following example shows an I/O file write operation supervisor call, writing to the logical 
relative record 56 in the relative record file that LUNO 3Ci6 has been previously assigned. 



SCBF 



DATA 





BYTE 


>0B,>3C 


DATA 





DATA 


FILOUT 


DATA 





DATA 


20 


DATA 





DATA 


56 



Write to the file that LUNO 3Ci6 is assigned. 

All the flag bits are turned off. 

Write it from the memory buffer FILOUT. 

Unused word. 

Write 20 bytes. 

Write it to record 56 of the relative record file. 






7.3 SUPERVISOR CALL 15i6 SUPPORT FOR TASKS DESIGNED TO RUN UNDER TX990, 
RELEASE 1.0 

The TX990 Operating System also supports the file utility supervisor call for tasks that were 
generated to run under the 1 .0 version of the TX990 Operating System. 

NOTE 

SVC 15 16 may not be supported on future releases; therefore, the 
user should use discretion in using/not using this SVC. 

File utility supervisor call 15i6 performs the following functions: 

• Assigns a LUNO to a device 

• Releases a LUNO assignment. 



yiis^^^\_ 



7.3.1 SUPERVISOR CALL 15i6 SCB FORMAT. The file utility supervisor call block for file 
utiUty supervisor call 15i6 consists of 12 bytes aligned on a word boundary. As shown in figure 7-3, 
the content of the supervisor call block is as follows: 
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15 16 (supervisor call code) in byte 

A byte reserved for a status code, byte 1 

Utility operation code in byte 2, either of the following: 

01 Assign LUNO to device 

03 Release LUNO assignment 

• User flags in byte 3, as follows: 

Zeros in bits through 4 

File Allocation bit - bit 5. Ignored by TX990. 

File Type - bits 6 and 7, set to zero for a device. 

• LUNO in byte 4 (FFje is illegal) 

• Vahdation identifier in byte 5. Not apphcable to TX990. 

• Record length in bytes 6 and 7. Not apphcable to TX990. 

• Device name in bytes 8 through 1 1 , consisting of up to four characters left-justified with 
trailing spaces (not required for release function). 

The status codes returned by the system in byte 1 at the completion of the function are Hsted in 
the error appendix. 



^ 



^ 



7.3.2 CODING EXAMPLE. The example below assigns LUNO 2 to cassette transport drive 2. 



DATA 


>1500 


DATA 


>0100 


DATA 


>0200 


DATA 





TEXT 


'CS2 ' 



Supervisor call code. 
Assign opcode. 
Luno. 

Cassette drive 2. 



^ 
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RELATIVE 
ADDRESS 



6 

8 

10 






1 2 3 4 5 


6 7 





t 


2 


3 


4 5 


6 7 


1 


15i6 


1 




1 t 1 1 
STATUS CODE 


1 




UTILITY OP CODE 
















AL 


TYPE 




LUNO 




VALIDATION IDENTIFIER 






RECORD LENGTH 








DEVICE NAME, CHAR. 1 




DEVICE NAME, CHAR. 2 




DEVICE NAME, CHAR. 3 






DEVICE NAME, CHAR. 4 



note: Q) RETURNED BY SYSTEM. ALL OTHER ITEMS SUPPLIED BY USER AS 
APPLICABLE 



(A)133424 



Figure 7-3. File Management Supervisor Call Block for File Management Supervisor Call 15i6 

7.4 VDT CHARACTER MODE SUPERVISOR CALLS 1 Aie, 8i6 , and I816 . 
With these supervisor calls, the user task can position the VDT cursor, w^rite or read fields of data on 
the VDT screen, and input characters from the VDT keyboard. The following supervisor calls are 
used for character mode operation: 

• VDT Utility Supervisor Call 1 Aie 

• VDT Character Input from Station Keyboard Supervisor Call 815 

• VDT Conditional Character Input from Station Keyboard Supervisor Call I816 

In the character mode, the user task first executes a VDT utiHty supervisor call 1 A16 , to open the 
VDT. Subsequent device I/O operations are performed using character input supervisor calls and 
utility supervisor calls. The VDT is taken out of the character mode by the VDT utility supervisor 
call that specifies the close device I/O operation. 

One or more VDTs may be designated in character mode or record mode, when the system is 
generated. VDTs designated in record mode may also use character mode I/O operations. Character 
mode device I/O operations address the VDT by the station number which is assigned to the VDT 
when the system is generated. 

The VDT character mode SVC 1 A16 is not supported by the DXIO system software. 

7.4.1 VDT UTILITY SUPERVISOR CALL lAie- VDT utility supervisor call lAi^ allows the 
following seven VDT I/O operations with a 91 1 or 913 VDT. 
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Opens the VDT, placing it in the character mode 

Positions the cursor 

Tabs the cursor to an unprotected field on the screen 

Reads a field of characters from the screen 

Writes a field of characters to the screen 

Writes a character in a specified number of character positions on the screen 

Closes the VDT, terminating the character mode. 

One or more of the above VDT I/O operations may be specified in this supervisor call by setting 
a bit to 1 in byte 2 of the supervisor call block. When more than one VDT I/O operation is speci- 
fied, the operations are performed in the sequence indicated in the above list of seven VDT I/O 
operations. 

The open device I/O operation must be performed before any other device I/O operation or super- 
visor call to the VDT. The user task supplies the station number of the VDT to be opened and 
requests the open VDT operation. The result is to enable character mode operation of the VDT. 
When the RC flag is set to 1 , the VDT open operation places the maximum values of row and 
column in bytes 6 and 7 of the supervisor call block, which is normally the buffer address. 

The cursor position VDT operation positions the cursor at any character of any line of the scree^. 
The user task supplies the station number of the VDT and the row and column to which the cursor 
is to be moved. 

The tab VDT operation positions the cursor at the leftmost character of an unprotected field. When 
characters are written on the screen, they are written either as protected or as unprotected charac- 
ters. When the cursor is at a position that contains a protected character, the tab VDT operation 
skips protected characters leaving the cursor at the leftmost character of the unprotected field to 
the right of the original position of the cursor. When the cursor is at a position that contains an un- 
protected character, the tab VDT operation moves the cursor to the leftmost character of the 
current unprotected field. The user task supplies the station number of the VDT for the tab VDT 
operation. 

The read characters VDT operation reads a field of characters from the screen at the cursor 
position. The task may specify a number of characters to be read, or may read all the characters in 
an unprotected field. This VDT operation also moves the cursor to the position following the last 
character read. The user task suppHes the station number of the VDT, the number of characters 
to be read, and the address of a buffer in which are placed the characters read from the screen. 

The write characters VDT operation writes a field of characters to the screen at the cursor position. 
The task specifies a maximum number of characters to be written. The operation terminates before 
writing the maximum number of characters if the operation detects a character having the most 
significant bit set. In that case, the operation negates the character code, writes the resulting char- 
acter, and terminates. The user task supplies the station number of the VDT, the maximum number 
of characters and the address of the buffer. 



^**^ 
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The write character (propagate) VDT operation writes the first character in the buffer into a field 
of characters on the screen at the cursor position. The task specifies the number of times the char- 
acter is to be written. The user task supphes the station number of the VDT, the number of 
characters to be written, and the address of the buffer that contains the character. 

The VDT close operation must be performed to terminate the character mode of the VDT. The 
VDT may then be opened for record mode operations when the VDT has been designated for both 
modes. The user task supplies the station number of the VDT to be closed. 

The user may specify that the operations of a VDT supervisor call be followed by a beep tone, or 
that the cursor remain disabled following the operations. All device I/O operations return the row 
and column of the cursor position at completion. 

7.4.1.1 VDT Utility Supervisor Call Block. VDT utiHty supervisor call block, shown in figure 7-4, 
consists of the following: 

• The code, lAi6, in byte 0. 

• Byte 1 reserved for a completion code (table 4-3). 

• Operation flags in byte 2, as follows: 

PR flag - bit 0, set to one to write protected characters. Set to zero to write un- 
protected characters. 

RC flag - bit 1, set to one to cause an open VDT operation. The maximum values 
for row and column are placed in bytes 6 and 7 of the supervisor call block. 



PC flag - bit 2, set to one for a position cursor VDT operation. 
T flag - bit 3, set to one for a tab VDT operation. 
R flag - bit 4, set to one for a read VDT operation. 
W flag - bit 5 , set to one for a write VDT operation. 
f^^ WP flag - bit 6, set to one for a write propagate device I/O operation. 

C flag - bit 7, set to one for a close VDT operation. 

• The station number in byte 3. 

• Control flags in byte 4, as follows: 

B flag - bit 0, set to one to provide a beep tone following the operations specified. 
CD flag - bit 1 , set to one to disable the cursor following the operations specified. 

• The row, for a position cursor device I/O operation, in bits 3 through 7 of byte 4. The 
range of values is through Bi6 for a 913 VDT, or through 17i6 for a 911 VDT. 
Returned by the system after each call. 

f^^ • The column for a position cursor device I/O operation, in bits 1 through 7 of byte 5. 

The range of values is through 4Fi6 • Returned by the system after each call. 
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• The address of a buffer in bytes 6 and 7. A read device I/O operation transfers characters 
into the buffer, a write function transfers characters out of the buffer, and a write 
propagate device I/O operation copies the first character in the buffer into one or more 
character positions on the screen. When bit 1 of byte 2 is set to one during an open 
operation, the maximum values of row and column are placed in bytes 6 and 7. 

• The number of characters for a read operation, in bytes 8 and 9. When zero, read the 
entire unprotected field. Otherwise, read the specified number of characters. 

• The maximum number of characters to be written in a write operation, or the number of 
characters to be written in a write propagate operation, in bytes 10 and 11. In a read 
operation, the system returns the actual number of characters read in these bytes. 

The system returns a complefion code in byte 1. The codes are listed in table 7-5. 



X*«?K 



RELATIVE 
ADDRESS 




PRB REL, 
ADDR. 

2 



10 






1 


2 


3 


4 


5 


6 


7 





12 3 4 5 


6 


7 








1 1 1 1 


1 1 1 "1 1 

COMPLETION CODE 


1 1 

© 




PR 


RC 


PC 


T 


R 


W 


P 


C 


STATION NUMBER 


B 


CD 




ROW 




COLUMN 


BUFFER ADDRESS 


NUMBER OF CHARACTERS - READ 


NUMBER OF CHARACTERS 



NOTE© RETURNED BY SYSTEM. ALL OTHER ITEMS SUPPLIED BY USER, 



(A)132858 



Figure 7-4. VDT Utility Supervisor Call Block 
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A^^\ 



Code 
(Hexadecimal) 


1 
4 
6 

7 

80 
NOTEl 



Table 7-5. VDT Utility Completion Codes 

Description 

Satisfactory completion. 

Illegal station number. 

Illegal cursor position specified. 

No unprotected field found in tab function. 

No unprotected field found in read function of 
unspecified length (Note 1) 

VDT currently in record mode or assigned to 
another task. 



When a read function that has no specified length does not read a pro- 
tected field, the full screen of characters is read before the operation is 
terminated in error. Contents of memory locations immediately above 
the buffer are destroyed when the buffer size is less than the screen 
size (960 characters for 913 VDT). (1920 characters for 91 1 VDT). 



7.4.1.2 Coding Example. The following are examples of coding for supervisor call blocks for VDT 
utility calls. 

SCBV DATA >1 A00,>A402,>4300,WBUFF,0,8 Station 2 is already opened, position 

the cursor at column of rov/ 3, 
and write eight protected charac- 
ters from buffer at location WBUFF, 
leaving the cursor disabled. 






SCVCT DATA >1A00,>5802,0,RBUFF,5,0 



SCBVC DATA >A100,>2902,>8220,RBUFF,4,0 



Open station 2, tab cursor, and 
read five characters into buffer at 
location RBUFF, with cursor 
enabled. 

Station 2 is already opened, posi- 
tion the cursor at row 2, column 32, 
read 4 characters into buffer at 
location RBUFF, close station 2, 
and sound a beep tone. 



(^ 
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7.4.2 VDT CHARACTER INPUT SUPERVISOR CALL 8i6 . The character input supervisor call, 
code 8i6 , inputs a character from a specified station keyboard. The calling task is suspended until 
the character is transferred. The system places the character in the most significant byte of the task 
workspace register 0. The supervisor call block consists of three bytes, and need not be aligned on a 
word boundary. Byte contains the code, and the system returns a value in byte 1. Byte 2 contains 
the station number. When the system is unable to locate the station, it returns -1 in byte 1. When 
the station has not been opened in the character mode, or when power is off at the station, the 
system returns 80i6 in byte 1 . Otherwise, the system returns zero in that byte. 



VDT character input call block: 

(A) 137501 

VDT conditional character input call block: 






8 


ERROR CODE | 


2 


STATION NUMBER 













^^16 


ERROR CODE 1 


2 


STATION NUMBER 





^^ 



(A)l 37502 

The following is an example of coding for a supervisor call block for a character input from station 
keyboard supervisor call: 

SCBC BYTE 8,0,2 Input a character from station 2 and place the 

character in the most significant byte of 
workspace register 0. 

7.4.3 VDT CONDITIONAL CHARACTER INPUT SUPERVISOR CALLt8i6. Conditional ^ 

character input supervisor call 18i6 inputs a character from a specified station keyboard. When a 

character is entered, the function sets the equal bit (bit 2) of the status register to 1 and places the 

character in the most significant byte of workspace register 0. When a character has not been 

entered, the function sets the equal bit of the status register to 0, indicating a "not equal" status. In 

either case, the function returns control to the calling task immediately. The supervisor call block 

consists of three bytes, and need not be aligned on a word boundary. Byte contains the code, and 

the system returns a value in byte 1 . Byte 2 contains the station number. When the system is unable 

to locate the station, it returns -1 in byte 1. When the station has not been opened in the character 

mode, or when power is off at the station, the system returns 80i6 in byte 1. Otherwise, the system 

returns zero in that byte. ''^^ 

The following is an example of coding for a supervisor call block for a conditional character input 
from station keyboard supervisor call: 

SCBT BYTE > 18,0,5 Input a character from station 5 and place it on the 

most significant byte of workspace register if a 
character has been entered at the keyboard. 

7.5 WAIT FOR I/O SUPERVISOR CALL 01 16 . 

Wait for I/O supervisor call 1 le places the calling task in suspension pending completion of a 
specified I/O operation. Wait for I/O supervisor call block Olie contains four bytes aligned on a 
word boundary as shown below. Byte contains the supervisor call code and byte 1 contains a zero. 
Bytes 2 and 3 contain the address of the second word in the supervisor call block that defines the 
I/O operation. When the specified I/O operation is not in progress, control is immediately returned 
to the calling task. ^.^ 
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(A)1 37503 



01 



16 



00 



16 



SCB ADDRESS + 2 



The following example shows coding for a supervisor call block for a wait for I/O call: 

SWBW DATA >100,SCB5+2 Suspend the calling task pending completion of the 

I/O operation defined in the SCB at location 
SCB5. 

NOTE 

The system will modify the original call block SCB by setting to 
zero bit of byte 5, which is set by the user to indicate initiate 

7.6 ABORT I/O SUPERVISOR CALL OF^e OPERATION. 

Abort I/O supervisor call OFie terminates I/O operations on the specified I/O device. The calling 
task is suspended during execution of the abort I/O supervisor call. If the device is file-oriented, it 
becomes unassigned. If the device is busy, the system sets the error flag in the supervisor call block 
for the current operation. No device operation is performed, and the medium remains positioned as 
the last I/O operation left it. That is, tape in a cassette is not backspaced or rewound, nor are the 
remaining cards of a deck read. Abort I/O supervisor call block OFie consists of two bytes which 
need not be aligned on a word boundary as shown below. Byte contains the code and byte 1 
contains the LUNO assigned to the device. 



1 ^s 


UJNO 1 



(A)137504 

The system returns zero as a status code in byte 1 when the operation completes successfully and -1 
(FFi6 ) when the LUNO specified in the SCB has not been defined. 

The following example shows the coding for a supervisor call block for an abort I/O call: 

7.7 ABORT I/O SUPERVISOR CALL BLOCK IE 

f^ SCBA BYTE >F,>11 Abort I/O to the device to which LUNO lli6 is 

assigned. 

An error code of 06i6 is returned by the system to the I/O SCB of the I/O operation being aborted. 

7.7 ABORT I/O SUPERVISOR CALL BLOCK lEie • 

Abort supervisor call lEie terminates an I/O operation defined by a specified Supervisor Call Block 
(SCB). The abort operation supervisor call block consists of four bytes aligned on a word boundary 
as shown below. Byte contains the code, and the system returns a status code in byte 1. Bytes 2 
and 3 contain the address of the second word in the SCB for the operation to be terminated. 



(A)137505 



IE 



16 



STATUS CODE 



SCB ADDRESS + 2 



The following is an example of coding for a supervisor call block for an abort supervisor call: 

SCBA DATA >1E00 ABORT I/O Operation Abort the I/O operation defined in a 
DATA SCBZ+2 Address supervisor call block at location SCBZ. 
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An error code of 06 16 is returned by the system to the I/O SCB of the I/O operation being aborted. ^„,„^^^^ 

NOTE 

This SVC is not supported by the DXIO system; therefore, SVC 
Fi6 should be used for aborting I/O. 



/<^»^ 



^^^ 



y^^im^ 
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SECTION VIII 
DISKETTE OCP SYSTEM UTILITY (SYSUTL) PROGRAM 

8.1 INTRODUCTION 

Basically, SYSUTL provides the operator with additional keyboard-command-control capabiHty for 
use with diskette devices and files and, therefore, functions as a diskette-related supplement to the 
Operator Communication Package (OCP). The SYSUTL commands are listed as follows: 

BC - Boot Copy MD - Map Diskette 

SF - Set System File MF - Map File 

CF - Create File DD - Diskette Dump 

DF - Delete File DL - Diskette Load 

CM — Compress File FD — File Dump 

f^^ CN - Change File Name FL - File Load 

CP - Change Protection ID - Initialize Date and Time 

DO - Define Output TI - Print Time and Date 

TE - Terminate 
CV - Change Volume Name 

In general, SYSUTL is a module of TX990 and a diskette-resident extension of the OCP module 
(described in Section III of this manual). SYSUTL may be executed under OCP or under the 
Terminal Executive Development System (TXDS) using console control in a manner similar to OCP. 
The following paragraphs describe the loading procedure, LUNOs, syntax, and the individual 
commands. The last paragraph in this section covers the SYSUTL error messages. 

8.2 LOADING SYSUTL 

SYSUTL can be loaded using the OCP module or in conjunction with the Control Program. When 
using the OCP module, perform the procedure itemized in paragraph 8.2.1. When using the Control 
Program perform the procedure itemized in paragraph 8.2.2. 

8.2.1 LOADING SYSUTL USING OCP. Load the program as follows: 

^ 1 . After loading the OCP in accordance with the procedure itemized in the section entitled 

Operator Communication Package, observe the printout or display on the system console 
of the period (.) prompt. 

2. Place the object module for SYSUTL in either the cassette or floppy diskette drive and 
ready the device. 

3. Using OOP's LP (Load Program) command, load the SYSUTL object module from 
the input media into memory as follows: 

LP,DSC2:SYSUTL/SYS Load from floppy diskette DSC2 the object 

module file SYSUTL/SYS. 
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An alternate method for loading the SYSUTL object module from cassette follows: 

LP,CS1. Load SYSUTL object module from cassette 

unit 1. 

4. Enter OCP'S EX (Execute) command to execute SYSUTL and terminate OCP as follows: 

EX,10.TE. Executes SYSUTL and terminates OCP 

5 . Observe the following printout or display on the system console : 
SYSUTL V.R. E YY.DDD SYSTEMS UTILITY 

6. After SYSUTL has started execution, the SYSUTL module causes the OP: prompt to 
be printed or displayed on the system console as follows: 

SYSUTL V.R. E YY.DDD SYSTEMS UTILITY 

OP: "^ 

7. At this step in the procedure, one or more SYSUTL commands, with a limit of up to 76 
characters on one line, may be entered on the system console. An example follows: 

OP: MD,DSC2.SF,DSC2:SYSFIL/SYS 

NOTE 



/<«ff^^ 



All of the commands must be entered on the same OP: line and not 
carried to another line. 

8. After SYSUTL executes the commands entered in the preceding step, observe that the 
OP: prompt is again printed out or displayed on the system console. 

9. At this step in the procedure, the operator has the choice of entering another SYSUTL 
command or terminating SYSUTL by entering a terminate response to the prompt as 
follows: 

OP: TE. ^ 

NOTE 

If an error occurs during execution of a command, the appropriate 
error message is issued. 

10. If TXDS is in the system, observe that SYSUTL has terminated when the following print- 
out or display is produced on the system console: 

TXDS V.R. E YY.DDD 

PROGRAM: 



^<w*x 
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8.2.2 LOADING SYSUTL USING THE TX990 OPERATING SYSTEM AND THE TXDS 

CONTROL PROGRAM. Load the program as follows: 

1 . After loading the TX990 Operating System in accordance with the loading procedure in 
the section entitled Loading the TX990 Operating System, bid the TXDS Control Pro- 
gram. This can be accomplished by use of the OCP module or without use of the OCP 
module. When the OCP module is used, enter EX,16.TE. in response to OCP's period (.) 
prompt to bid the TXDS Control Program and proceed to the next step. When the OCP 
module is not present, enter an exclamation point (!) to bid the TXDS Control Program 
and proceed to the next step. 

2. Observe the following printout or display on the system console: 
TXDS V.R.E. YY.DDD 

PROGRAM: 

#»v 3. Enter the pathname of the SYSUTL object module in response to the PROGRAM: 

prompt as follows: 

PROGRAM: :SYSUTL/SYS 

4. Depress the carriage return key and observe that the INPUT: prompt is printed out or 
displayed on the system console. 

NOTE 

I The asterisk (*) feature can be used in lieu of the carriage return/ 

NEW LINE entry to by pass the remaining prompts (Input, Output, 
Options). 

5. Make a null entry by depressing the carriage return and observe that the OUTPUT: 
prompt is printed out or displayed on the system console. 

6. Make a null entry by depressing the carriage return and observe that the OPTIONS: 
prompt is printed out or displayed on the system console. 

7. In response to the OPTIONS: prompt, only one SYSUTL command can be entered on 
the system console (with a limit of up to 30 characters on the same line). For example: 

OPTIONS: MD,DSC2 

NOTE 

1. When multiple SYSUTL commands are to be entered, the 
response to the OPTIONS: prompt must be a carriage return 
(i.e., a null entry). This will cause SYSUTL to print or display 
the OP: prompt on the system console to which prompt the 
operator responds with one or more SYSUTL commands (with 
a limit of up to 76 characters on one line). 

2. A SYSUTL command may not be continued on the next line. 
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3. When multiple SYSUTL commands are entered, SYSUTL 

processes each mdividual command, one at a time, until it has ^ 

no more commands to process, at which time the operator can 
enter a TE (Terminate) SYSUTL command. This, in turn, 
causes the TXDS Control Program to be rebid. 

8. After the SYSUTL command entry is made in response to the OPTIONS: prompt, 
observe that the TXDS Control Program is rebid and the following printout or display 
is presented on the system console: 

TXDS V.R.E YY.DDD 

PROGRAM: 

8.3 LUNOs 

SYSUTL uses LUNO 0, LUNO 6, and LUNO 7. LUNO is assigned to the system console. All com- 
munications between operator and task, including error messages, are performed through LUNO 0. 
LUNO 6 is assigned by SYSUTL to the diskette being accessed by all diskette-related commands. 
LUNO 7 is internally assigned to the default print device upon loading SYSUTL and is used as 
the SYSUTL output LUNO for any printer output. The user has the option to redirect any printed 
output, excluding error messages, to a device other than the default print device by executing 
the Define Output (DO) command (described in one of the paragraphs below). 

8.4 SYSUTL COMMAND FORMAT AND SYNTAX 

Each command consists of a command word, optionally followed by one or more operands. 

SYSUTL recognized a command by the first two letters of the command word, the command key. 

These letters may be followed by additional letters or by blanks. One or more blanks, or a comma, ^ 

may separate a command key and its operands. However, embedded blanks are not allowed within 

the command word or an operand. 

If Systems Utihty is executed using OCP, more than one command may be entered in a single line, 
which may contain up to 72 characters and must be terminated by a carriage return (NEW LINE on 
913 VDT). When more than one command is entered on a Hne, each command must be terminated 
with a period, except the last command on the line, then it may be omitted. When an error is 
detected in a command, any subsequent command on that line is ignored. 



SYSUTL syntax also entails the following items and/or rules: 

Angle brackets < > enclose items required to be suppHed by the user 

Brackets [ ] enclose optional items 

Braces { \ enclose alternative items, one of which must be entered 

An elUpsis ( ) indicates that the preceding items may be repeated 

Items shown in capital letters must be entered as shown 
Pathname is described in 1.4.1. 



.^^ 
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8.5 SYSUTL COMMANDS 

(f^^ SYSUTL provides commands to initialize the time and date and to display the time and date. 

SYSUTL also provides a command to define a listing device for the display commands. All the re- 
maining commands deal with functions that involve the diskette. SYSUTL has a command to in- 
voke every file utility operation: create a file; delete a file; compress a file; change a file name; and 
change protection on a file. SYSUTL also supports maintenance functions for the diskette: map the 
diskette, which displays the file names along with various information of all the files on the 
diskette; map file, which displays information for a single file; disc dump, which displays absolute 
locations on the diskette; disc load, which writes to absolute locations on the diskette; file dump, 
which displays physical sectors within a file; and file load, which writes to physical sectors within 
a file. 

SYSUTL provides two commands for maintenance of a system diskette. The first command is 
Boot Copy (BC) which copies the TXBOOT program to diskette. The second command is Set 
System File (SF), which allows the user to define any object file as the file that will be loaded as 
the Operating System. The system file pathname must be defined before the Operating System 
loading procedure is performed. (Refer to the loading procedure in Section II of this manual for 
f^ additional information.) 

If a null entry is made wherever a device is to be specified, the default-substitute will be the system 
diskette which is specified during system generation. There will be no other defaults. 

All numeric output is in decimal except the output from the Diskette Dump (DD) and File Dump 
(FD) commands. These dumps are in hexadecimal. 

8.5.1 BOOT COPY (BC). The Boot Copy (BC) command causes a copy of the TXBOOT program 
to be written on the specified diskette. A diskette ROM loader cannot be used to load the Operating 
System or a stand-alone program from diskette until the TXBOOT program is written to the diskette 
that will be used during loading. The syntax of the command is presented as follows: 

BC,|<device>. \ 

(<volume>.f 

The operand must be a one-to-four-character diskette or volume name. There is no 
default-substitute for the device operand. Upon executing the BC command, the TXBOOT program 
is copied to physical tract of the specified diskette. The following is an example of the Boot Copy 
f^^ (BC) command: 

0P:BC,DSC2. The TXBOOT program is copied to physical track 

0ofDSC2. 

8.5.2 SET SYSTEM FILE (SF). The Set System File (SF) command defines a diskette file to be 
loaded as the Operating System or as a stand-alone program. The syntax is as follows: 

SF,<pathname>. 

The file designated by the specified pathname is the file that contains the linked object code that is 
to be loaded and executed as the Operating System or as a stand-alone program. Refer to the 
diskette/cassette ROM loader description for further details on loading. An example of the Set 
System File (SF) command follows: 

OP:SF,DSC:TX990/SYS. The file TX990/SYS on DSC is to be used as the 

Operating System file when the diskette is booted. 
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8.5.3 CREATE FILE (CF). The Create File (CF) command creates a sequential or relative record .-..^ 
file. The syntax for the command is as follows: ^ 

CF,<pathname>[,<RR>,<record length>] . 

The pathname operand is the name assigned to the file upon its creation. The newly created file is a 
noncontiguous sequential file unless the optional operand 'RR' follows the pathname. If 'RR' is 
specified, the file is created as a noncontiguous relative record file with the specified record length. 
For relative record files, the recrod length must be given. Record length is assumed to be decimal 
unless preceded by '>'. All files are created unprotected and have a protection code of 'U'. 

The following are examples of the CF command: 

0P:CF,DSC2:FILE/SEQ. Create sequential file named 'FILE/SEQ' on DSC2. 

OP:CF,VOL1:RELREC,RR,>80. Create relative record file names 'RELREC with 

record length of SOie on the diskette with the 
volume name VOL 1 . "^^^ 

8.5.4 DELETE FILE (DF). The Delete File (DF) command deletes the specified file from the 
diskette. The syntax for the command is as follows: 

DF,<pathname>. 

The following question is issued: 

ARE YOU SURE??? ^ 

Only one character is accepted. If any response is entered other than a 'Y' for 'yes', the delete file 
command is ignored. Upon entering a 'Y', the specified file is deleted from the diskette. An 
example of the DF command follows: 

OP:DF,DSC:TEMPFIL 

ARE YOU SURE??? Y Upon entering 'Y', the file TEMPFIL' is deleted from 

DSC. 

8.5.5 COMPRESS FILE (CM). The Compress File (CM) command returns to the Operating System 
all allocation units (AUs) beyond the EOF for the specified pathname. 

CM,<pathname>. 

The pathname operand must be a vahd pathname as defined in the section in this manual entitled 
File Management Executive Supervisor Calls. The Compress File command compresses the desig- 
nated file to its minimum size. The following is an example of the CM command: 

OP: CM,:OCPFIL/SRC. Compresses file 'OCPFIL/SRC on system default diskette. 

8.5.6 CHANGE FILE NAME (CN). The Change File Name (CN) command changes the file name 
and extension of an existing file to the new pathname as specified. The syntax of the command is as 
follows: 

CN,<old pathname>,<new pathname>. '"^^^ 
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Both the old pathname and new pathname operands must be valid pathnames as defined in section I 
of this manual. The file with the specified old pathname retains all its directory information such as 
protection code and file type. Only the name of the file on the diskette is changed. The following 
is an example of the CN command: 

OP: CN,DSC2:OCPFLl,DSC2:OCPFIL/SYS. Changes the name of the file that is cur- 

rently Hsted in the file directory on DSC2 
as OCPFLl to the new file name OCPFIL/ 
SYS. 

8.5.7 CHANGE PROTECTION (CP). The Change Protection (CP) command changes the file 
protection code of the specified file to the new protection code. The syntax of the command is 
as follows: 




CP,<pathname>, 

The pathname operand must be a vaHd pathname. The existing protection code of the specified 
file is changed to the newly defined protection code. The second operand is a one-character 
abbreviation of the possible protection code as follows: 

U — Unprotect File (File is Unprotected) 

D - Delete Protect File (Protects File from Being Deleted) 

W - Write Protect File (Protects File from Being Written On or Deleted) 

If the specified file is already open, the new protection will not be in effect until the file is closed. 

The following is an example of the CP command: 

OP: CP,DSC:LIST80/SYS,W. Protects the file 'LIST80/SYS' on DSC from being written 

over or deleted. 

8.5.8 DEFINE OUTPUT (DO). The Define Output (DO) command directs the displays of several 
SYSUTL commands to the specified device. The syntax of the command is as. follows: 

DO,<device>. 

All displays are directed to the default print device until changed. The DO command allows the 
printed output of the following commands to be directed to the specified device: 



MD - 


Map Disc 


MF - 


Map File 


DD - 


Disc Dump 


FD - 


File Dump 


TI - 


Print Time and Date 


ID - 


Initialize Date and Time 
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The device operand is a one- to four-character device name. 

If SYSUTL is terminated and then rebid without reloading, the use of the last output device 
assigned will be resumed. The following is an example of the DO command: 

OP: DO,LP. Redirects all displays (excluding error messages) to the line 

printer until the DO command is reexecuted. 

OP: DO. Displays are resumed to the default print device, which 

is the system console for standard TI supplied Operating 
Systems. 

8.5.9 MAP DISKETTE (MD). The Map Diskette (MD) command maps the specified diskette by 
file name, by extension, or maps every file on the diskette to the display device. The syntax for the 
command is as follows: 



MD 



J<device> ) 
(<volume>/ 



(,<extension>) 
(<file name> f 



/««!St?\ 



If no device is specified, the operating system diskette is used. The device operand is a one- to four- 
character device name that is to be mapped. The extension operand consists of a slash immediately 
followed by a one- to three-character extension name which will be used to map the diskette. To 
map the diskette according to a specified file name, a colon must be entered and immediately fol- 
lowed by a one- to seven-character file name. 

The Map Disc command outputs the Diskette Identification field, the total number of allocation 
units on the specified diskette, and the number of available and bad Allocation Units (AUs) on the ""^^ 

diskette. MD also lists the name of all files on the diskette, their file type, file protection code, and 
the total number of AUs allocated to each file. The command output is terminated with the print- 
ing of the time and date. 

The following are examples of legal MD commands: 

MD,DSC2:FILE/. Map all files with the name FILE and any extension 

on DSC2. 

MD,V0L2:FILE/. Map all files with the name FILE and any extension l 

on the diskette with volume name V0L2. 

MD,VOL/OBJ. Map all files with the extension OBJ on volume VOL. 

MD,/SRC. Map all files on the default disc with the extension 

SRC. 

MD,V0L3 . Map all files on volume VOLS . 

MD,:TASK1/. Map all files on the default disc with the name 

TASKl and any extension. 

It is not legal to give both a file name and an extension in a Map Diskette command. 
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The output of the MD command may be directed to any desired device using the Define Output 
command. Output of the MD command is sorted alphabetically by file name and extension. The 
following are examples of the Map Disc command: 



OP: MD. 



Maps all of the default diskette. 



DISC I. D. : TX990 1/27/77 
DSC ALLOC. UNITS(TOTAL): 333 FREE; 

FILE TYPE PT ALLOC. UNITS 



BAD: 



DSKDMP/SYS 


S 


U 


18 


IBMUTL/OBJ 


S 


U 


20 


SCRATCH/SRC 


S 


U 


8 


SCRTCH 


S 


U 


102 


SOURCE/SRC 


s 


U 


8 


SYS012 


s 


U 


8. 


SYS0127/SYS 


s 


U 


102 


TEMP/SRC 


s 


U 


8 


TEMP/TMP 


s 


U 


7 


TXEDIT/SYS 


s 


U 


22 


TXTSTl/SRC 


s 


U 


8 


TXTST2/0BJ 


s 


U 


8 


TXTST3/0BJ 


s 


u 


8 


10:45:35 


FEB 3, 


1977 




OP: MD,/SYS. 






Maf 



Maps all files on default diskette with the extension 'SYS'. 



DISC I. D. : TX990 1/27/77 
DSC ALLOC. UN ITS (TOTAL). 333 FREE: 
FILE TYPE PT ALLOC. UNITS 



BAD: 



DSKDMP/SYS 
SYS0127/SYS 
TXEDIT/SYS 

10:46:08 



S 
S 
S 



U 
U 
U 



FEB 3, 1977 



18 

102 

22 



8.5.10 MAP FILE (MF). The Map File (MF) command outputs pertinent informafion of the 
specified file to the defined output device. The syntax for the command is as follows: 

MF,<pathname>. 
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10:47:41 FEB 3, 1977 



yoem^ 



The pathname operand specifies the name of the file that is to be mapped and the device on which 
it is located. This command displays the type of file, whether sequential or relative record, the 
file-protection code, the record length if it is a relative record file, and the number of allocation 
units (AU) contained in the file. The MF command also outputs the starting allocation unit num- 
ber and the number of units contained in each block allocated to the specified file. The command 
output is terminated with the printing of the time and date. The following are examples of the Map 
File (MF) command for a sequential record file. 

OP: MF,DSC:DSKDMT/SYS. Map file 'DSKDMT/SYS' on diskette DSC. 

NAME: DSKDMT/SYS TYPErS PT:U REC LENGTH: # A. U, : 18 

START ALLOC. UNIT # OF UNITS 

200 16 

240 2 

10:46:52 FEB 3, 1977 ^^ 

8.5.11 DISKETTE DUMP (DD). The diskette Dump (DD) command causes SYSUTL to print the 
contents of the specified absolute diskette locations on the defined display device. The syntax for 
the command is as follows: 

DD[ , <device>] ,<alloc unit>,<sector>[,<start byte>[,<end byte>] ] . 
DD,T[,<device>] ,<track>,<sector>[,<start byte>[,<end byte>] ] . 

The Diskette Dump command may be executed in either of two modes: by allocation unit or phys- .<-«% 

ical track. If the diskette is to be accessed by track, a "T" must be entered immediately after the 
command key 'DD'. The optional device operand is a one- to four-character name. If the device 
operand is omitted, the default system diskette as specified during system generation is used. The 
allocation unit operand is a one- to three-digit number that specifies the desired allocation unit. 
If the dump is to be performed by physical diskette track, the track operand is a one- to two-digit 
number that specifies the desired track. The sector operand is a one- to two-digit number that 
designates a sector on the allocation unit or track. The next two operands are one- to four-digit 
numbers that specify the starting and ending byte addresses within the sector to be printed. When 
only the starting byte is entered, the contents of the word that contains the specified byte as well 
as the remainder of the sector, are printed. When both the starting and ending byte addresses are "^ 

omitted, the contents of the entire sector are printed. 

All numeric operands (allocation unit, track, sector, starting and ending byte) are assumed to be 
decimal unless otherwise preceded by a '>' for hexadecimal. The following is an example of the 
Diskette Dump (DD) command and the resulting printout: 

OP: DD,12,0,>10,>30 Dumps sector of allocation unit 12, byte lOi^ through 

30i6 on default diskette. 

0010 3641 3043 3043 3041 4231 3030 3837 4631 6A OC OC OA Bl 00 87 Fl 
0020 3445 4620 5458 3939 3030 3535 FF42 3036 4E F TX 99 00 55 .B 06 
0030 4130 AO 
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The contents of sixteen bytes are printed per line following the address of the first byte printed on 
^^^ the hne. The contents of each pair of bytes are shown as four hexadecimal digits. At the right end 

of the line, the contents are printed as ASCII characters. The bytes that contain values that corre- 
spond to printable ASCII characters are translated and printed as ASCII characters. The nonprinting 
ASCII characters are printed as periods. The display is terminated with the printing of the time and 
date. 

8.5.12 DISKETTE LOAD (DL). The Diskette Load (DL) command places the specified data on 
a diskette at a specified address. The Diskette Load command may be performed by allocation units 
or by physical track. The syntax for the command is as follows: 

DL [,<device>] ,<allocation unit>,<sector>,<starting byte>,<data>[,<data>...] 
DL,T[,<device>] ,<track>,<sector>,<starting byte>,<data>[,<data>....] 

If the diskette is to be accessed b> .rack, a T' must be entered immediately after the command key 
'DL'. The optional device operand is a one- to four-character device name. If the device operand is 
omitted, the default-substituted system diskette as specified at SYSGEN time is used. The 
allocation-unit operand is a one- to three-digit number which specifies the allocation unit to be ac- 
i^^ cessed. A number consisting of one to two digits is entered for the track operand if the diskette is 

to be accessed by physical track. The sector is a one- to two-digit number that specifies a sector on 
the allocation unit or track that is to be loaded. The starting byte is a one- to four-digit byte address 
into which the first data value is placed. If the byte address is odd, the previous even-byte address 
will be used. When additional words of data are entered, they are placed in successive addresses. 

All numeric operands (allocation unit, track, sector, starting byte, data) are assumed to be decimal 
unless otherwise preceded by a '>' for hexadecimal. The following is an example of a Diskette 
Load (DL) command: 



n 



r^' 



/^i^^^N^ 



OP: DL,DSC2,1,3,>20,>5448,>4453,32,57. Place the ASCII codes for the characters 

T, X, D, and S in bytes 20i6 through 
23 16 and decimal data in bytes 24i6 
through 27 16 of sector 3 of allocation unit 
1 onDSC2. 

CAUTION 

The DL command has the capabihty of modifying any data on the 
system diskette, including the Operating System file and Operating 
System file structures. Verify the address by performing a DD com- 
mand that specifies the same allocation unit or track, and sector be- 
fore entering a DL command. When the contents do not agree with 
the contents of the bytes to be altered, determine the correct AU 
track and sector before proceeding. 

8.5.13 FILE DUMP (FD). The File Dump (FD) command causes SYSUTL to print the contents 
of a specified physical sector of a specified diskette file. The syntax of the command is as follows: 

FD,<pathname>,<sector>[,,<starting byte>[,<ending byte>] ] . 

The pathname operand specifies the name of the file and the diskette unit on which it is located 
that is to be dumped. The sector operand is the number of the sector that is to be accessed relative 
to the beginning of the file. The next two operands, the starting and ending byte, are one- to four- 
digit addresses within the sector to be printed. When only the starting byte is entered, the contents 
of the word that contains the specified byte are printed. When the byte addresses are omitted, the 
contents of the entire sector are printed. The contents are printed in hexadecimal representation 
and in ASCII character representation. A nonprinting character is represented by a period. The dis- 
play is terminated with the printing of the time and date. 
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OP: ID, 1977 2,12,17,29 Initialize the time and date to 5:29 PM, February 12, 1977. 

17:29:00 FEB 12, 1977 

8.5.16 PRINT TIME AND DATE (TI). The Print Time and Date (TI) command causes SYSUTL 
to print the time and date. The syntax for the command is as follows: 

TI. 

The command requires no operands. The following example shows a TI command and the resultant 
output. 

OP: TI. 

9:29:12 FEB 13, 1977 



^^m?^ 



All numeric operands (sector, starting byte, ending byte) are assumed to be decimal unless other- 
wise preceded by '>' for hexadecimal. The following is an example of a File Dump (FD) command 
and the resulting output: 

OP: FD,DSC2:SYSUTL/SYS,1„>36. Dumps sector 1, bytes through 36i6 of 

file SYSUTL/SYS on DSC2. 

8.5.14 FILE LOAD (FL). The File Load (FL) command places the specified data in specified 
bytes of a diskette file record. The syntax for the command is as follows: 

FL,<pathname>,<sector>,<startingbyte>,<data>[,<data>....] 

The pathname operand specifies the name of the file and the diskette unit on which it is located 
that is to be accessed. The sector operand is a one- to two-digit number presenting the sector to 
be loaded relative to the beginning of the file. The starting byte is a one- to four-digit address into 
which the first data value is placed. When an odd number is entered for the starting byte, the value 
is placed in the even address immediately preceding the odd value. When additional words of data 
are entered, they are placed in successive addresses. 

All numeric operands (sector, starting byte, data) are assumed to be decimal unless otherwise 
preceded by a >' for hexadecimal. The following is an example of an FL command: 

OP: FL,DSC:TEMPFIL,2,0,>444D,>4879. Places 444Di6 and 4879i6 into bytes 

through 3 of the second sector in 
TEMPFIL on DSC. 

8.5.15 INITIALIZE DATE AND TIME (ID). The Initialize Date and Time (ID) command -^ 
initializes the date and time values for the system. The syntax for the command is as follows: 

ID,<year>,<month>,<day>,<hour>,<minute>. 

The year operand is the four-digit decimal number of the years 1976 through 1999, and the month 
operand is the decimal number of the month 1 through 12. The day operand is a one- or two-digit 
decimal number, 1 through 3 1 , and the hour operand is a one- or two-digit decimal number, 
through 23. The minute is the decimal number of the minute through 59. The second is set to 
zero when the command is entered. An example of an ID command follows: 



Z)^^^ 



/^!^|^ 
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r^ 



r^' 



When the date and time have not been initialized, no date is printed and the time printed is the 
elapsed time from the most recent loading of the Operating System or from system restart. 

8.5.17 TERMINATE SYSUTL (TE). The Terminate SYSUTL (TE) command terminates execu- 
tion of SYSUTL and releases all related LUNOs. If the TXDS Control Program is linked with the 
TX990 Operating System, it will be rebid. The syntax for the command is as follows: 

TE. 
The command requires no operands. 

8.5.18 CHANGE VOLUME NAME (CV). The change volume (CV) command causes SYSUTL to 
change the volume name of a diskette to a new volume name. The syntax for the command is as 
follows: 

CV, f <device> 1 , / , 

l<volume>J '<volume>. 

The first parameter defines the old volume name or device. The second parameter defines the new 
volume name. It is wise to avoid volume names that are also device names, because the TX990 
operating system will not be able to find the correct volume. 

When a volume name for a disc has not been defined, it may be defined by using the device name, as 
follows: 



/^^^•s, 



CV,DSC2,VOL2. 

8.6 SYSUTL ERROR MESSAGES 

The error messages capable of being issued by SYSUTL are listed in table 8-1. When more than one 
SYSUTL command is entered on a line and an error occurs, the command in error (or that caused 
the error) and all subsequent commands in the statement must be entered again. Unless otherwise 
noted, when an error occurs, the command is ignored and SYSUTL prompts for input. 






Message 
♦INVALID COMMAND* 

I/O ERROR, IGNORED 
OUTPUT ERROR 



Table 8-1 . SYSUTL Error Messages 
Meaning 

The command word is not valid. 



An I/O error was detected during 
reading of the command. 



An error was detected during output 
and execution of the command has 
been terminated. 



Recovery 

Check the command word, and re- 
enter correctly. 

Input from the system console was not 
received correctly. Check the device, 
and reenter the entire line. 

This message is printed when the user 
has entered an ESC character to ter- 
minate output, or if LUNO 1 has not 
been assigned. If neither of these 
applies, check device for errors. 



y^pPsfi^Sy 
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Message 
UNDEFINED ERROR 



OPERAND ERROR(S) 



BAD DEVICE 



DEVICE OFF LINE 



INVALID DISC 
ADDRESS 

BAD FILE NAME 



INVALID INPUT 
PARAMETER 

DUPLICATE FILE NAME 



FILE NAME UNDEFINED 
DISKETTE FULL 



FILE DELETE PRO- 
TECTED — UNABLE 
TO DELETE 

INVALID FILE PRO- 
TECTION SPECIFIED 



Table 8-L SYSUTL Error Messages (Continued) 

Meaning Recovery 



1 . TX990 returned an error code to 
SYSUTL that is not recognized by 
SYSUTL. 



2. Attempted SF with write 
protect on. 

One or more operands are invahd. 



Invalid device name. 



Specified device not on line. 



Invalid track, AU, or sector 
specified. 

Specified pathname has a syntax 
error. 

Bad parameter in supervisor call 
block. 

File already exists with specified 
filename. 

Specified file does not exist. 

No available allocation unit or 
diskette. 

Delete File command. Attempted 
to delete file that is write-protected 
or delete-protected. 

Change File protection command. 
Protection specified is not valid 
character: 'U', 'D',or 'W. 



1. This is a system error. Make an- 
other attempt to enter the com- 
mand. If error recurs, reinitialize 
the system, 

2. Turn off write protect. 



When a required operand has been 
omitted, enter the complete com- 
mand. When a numeric operand is re- 
quired, but a nonnumeric operand was 
entered, enter the command with the 
correct type of operand. 

Enter the command with one of the 
device names assigned when the sys- 
tem was generated. 

Check diskette device. If power off or 
diskette not installed in drive, correct 
and reissue command. 

Check command operands and reenter 
correctly. 

Check pathname input and reenter 
correctly. 

Reload and execute SYSUTL. 



Check file name and reenter correctly. 



Check file name and reenter correctly. 

Delete any unnecessary files and/or 
compress files. Printer command. 

If you wish to delete the specified file, 
it must first be unprotected. 



Reenter file-protection code. 



/"nm'x 



-^ 



,x*%. 



^^ 
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Message 



UNABLE TO READ DISC 



Table 8-1. SYSUTL Error Messages (Continued) 

Meaning Recovery 

Error occurred while reading Reenter command, 

diskette. 



UNABLE TO WRITE DISC Error occurred while writing to 

diskette. 



Reenter command. 



^^K 



CAN'T OPEN OUTPUT 
LUNO 



CAN'T LOAD PAST END 
OF SECTOR 

UNABLE TO GET 
REQUIRED MEMORY 



SYSUTL output LUNO is already 
in use by another task. 



Diskette Load or File Load command. 
Specified sector not in range of file. 

Memory required to execute speci- 
fied command is not available. 



If a record mode I/0-operation to the 
LUNO is in progress, enter the com- 
mand again after the operation is com- 
pleted. If the LUNO is assigned to a 
fQe-oriented device that has been 
opened, enter the command again 
after the LUNO has been closed. 

Check desired sector number and 
reenter command correctly. 



UNABLE TO GET COMMON 



FILE DIRECTORY EMPTY 



Error occurred in trying to get 
COMMON. 



Map Diskette command. Attempted 
to map a diskette which has no files 
on it. 



Verify that TX990 has COMMON. If 
not, the system must be regenerated 
to include COMMON, 

Check device name and reenter corr- 
rectly. 



INPUT PARAMETER OUT 
OF RANGE OF SECTOR. 



Byte address specified not in range 
of sector. 



Check input and reenter command 
correctly. 
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SECTION IX 
SYSTEM GENERATION 

9.1 INTRODUCTION 

The GENTX utility program provides the user with the capabiHty of generating an operating system 
customized to the user's specific hardware and software configuration. Basically, the customized 
operating system is generated as follows: 

• First, GENTX is used to produce source code for two source modules: TXDATA and 
TASKDF. The TXDATA source module is used for providing the data needed by the 
operating system to enable its communicating with (i.e., controlling) each device in the 
user's total hardware configuration. (Whenever another device is added to the user's 
hardware configuration, it is necessary to add data to the TXDATA source module.) The 
^ TASKDF source module is used for providing the data needed by the operating system to 

enable execution of any of the various Tl-supplied modules/tasks (e.g., File Management, 
Operator Communications Package, Start Task, Diagnostic Task, etc.) or of any user- 
supplied tasks/programs (including user-utilities). 



• 



Second, an assembler is used to assemble the TXDATA and TASKDF source modules 
into object modules. 



• Third, a linker is used to link TXDATA and TASKDF object modules to other selected 
^^ object modules such as a user task/program, the File Management utiUty program, the 

r Operator Communications Package, Start Task, Diagnostic Task, etc. This linked object 

module is the resultant customized Operating System. 

The following paragraphs describe these steps in detail. 

9.2 PREPARATION FOR GENERATING A TX990 OPERATING SYSTEM 

In preparation for generating a customized TX990 operating system, the user must select the 
peripheral devices to be included in his system and assign Communications Register Unit (CRU) 
addresses and interrupt levels for each of those devices which can be obtained from the chart that 
is pasted on top of the Model 990/4, Model 990/5, or Model 990/10 computer chassis. 



The user must write and assemble a Device Service Routine (DSR) for each type of device not 
supported by any of the Tl-supplied TX990 modules. The DSR must process interrupts generated 
by the device and I/O calls to the device. The devices supported by Tl-supplied modules are listed 
in Section I. The user must also write and assemble user-supplied routines (e.g. supervisor calls, ex- 
tended operations) and include the object code when linking the system. Appendix C contains 
detailed information about writing such routines. 

9.3 DEFINING THE NEW SYSTEM 

Definition of a new operating system is accomplished by executing the GENTX utiHty program. 
GENTX prompts the user to define various parameters, as well as devices connected in the system. 
After all parameters have been defined GENTX builds two source modules, TXDATA and 
TASKDF, which form part of the operating system kernel. 
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9.3.1 LUNOS USED BY GENTX. GENTX uses the system console for user interactions and 
LUNO IO16 for file output. 

9.3.2 LOADING AND EXECUTING SYSTEM GENERATION (GENTX) UTILITY PROGRAM. 

GENTX may be loaded and executed using a TX990 or DXIO Operating System. The following 
paragraphs describe how to load and execute GENTX using a TX990 Operating System, or TXDS, 
or DXIO release 3.2 system. 

9.3.2.1 Loading and Executing Using TXDS. When executing GENTX using TXDS Control 
Program in a system without OCP, place the GENTX object module in the appropriate input device 
and perform the following steps: 

1 . Enter an exclamation point (!). 

2. Enter the GENTX pathname to the "PROGRAM:" prompt as follows: 

PROGRAM: :GENTX/SYS* If the object program for GENTX is in diskette 

file, :GENTX/SYS. 

PROGRAM : CS 1 * If on Cassette 1 . 

PROGRAM : CR* If on Card Reader. 

After GENTX starts executing it will display the following title message: 

GENTX V.R.E YY.DDD TX990 SYSGEN 

9.3.2.2 Loading and Executing GENTX with TX990 Using OCP. When executing GENTX on a 
TX990 system using OCP, place the GENTX object module in the appropriate input device and 
perform the following steps: 

1. Enter an exclamation point (!) at the keyboard of the system console to activate OCP. 
OCP responds by printing a period (.) to request a command. 

2. Enter an OCP command to load GENTX in the dynamic task area. The following are 
examples of commands to load GENTX: 

LP,CS1,3. Load task GENTX at priority level 3 when the 

object module is on Cassette Unit 1 . 

LP,CR,3. Load task GENTX at priority level 3 when the 

object module is in the Card Reader. 

LP,:GENTX/SYS. Load task GENTX at priority level 3 when the 

object module is in diskette file. 

3. Enter the following OCP command to execute GENTX and terminate OCP: 

EX,10.TE. Execute the task in the dynamic task area, 

GENTX and terminate OCP. 



^ 
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After GENTX starts executing it will display the following message: 

GENTX V.R.E YY.DDD TX990 SYSGEN 

9.3.2.3 Loading and Executing GENTX with DXIO Release 3.2. For details on the DXIO release 
3.2 process, refer to Appendix K. 

9.3.3 DEFINITION PHASE. GENTX begins execution in the definition phase, in which GENTX 
requests the user to enter system parameters and constructs an internal table of data from which 
GENTX later constructs the source statements for TXDATA and TASKDF. GENTX prints the 
request on the system console, and the user enters the parameters on the keyboard of the same 
device. In the following paragraphs, numeric parameters are specified as hexadecimal or decimal 
numbers according to the type of number that normally would be used. Either hexadecimal or 
decimal values may be entered for any numeric parameter. A hexadecimal number is preceded by a 
greater-than (>) character. If at anytime the user wishes to terminate GENTX, enter an asterisk. 
Table 9-1 shows all of the prompts which may be displayed by GENTX, and gives information 
concerning correct repUes. The following paragraphs describe each prompt. 

9.3.3.1 General System Definitions. The first prompt displayed by GENTX is as follows: 

MEMORY AVAILABLE- 

The user enters the amount of memory (bytes) available to GENTX to be used for table storage 
(there is no default value). The total memory available may be calculated by subtracting the size 
of GENTX (3650i6 bytes) from the total memory available. The suggested memory allocation 
is 2OOO10 bytes. 

The following prompts are requesting timing information that will be used by the task scheduler 
within the new TX990 Operating System being generated. 

LINE FREQ.- 

The user enters the power-Hne frequency, a decimal value followed by a carriage return. The vaUd 
parameters are 50 for 50-Hz power-line frequency or 60 for 60-Hz power-line frequency. When a 
carriage return only is entered, GENTX uses the default value, 60. 

(^^ The next request is as follows: 

TIME SLICING (Y or N) - 

The user enters a Y (Yes) if time slicing is desired or an N (No) if time sHcing is not desired. The 
default is Y. If a Y, or default, is entered, the following prompt is issued: 

TIME SLICE VALUE- 

The user enters the number of system time units the task scheduler will give a task per time slice. 
A system time unit is equivalent to 50-ms. The default is 1. 

The next request is as follows: 
TASK SENTRY (Y or N) - 



/^^^^^ 
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The user enters Y (Yes) if the task sentry option is desired, or an N (No) if it is not. The default is 
N. If a Y is entered, the following prompt is issued: 

TASK SENTRY VALUE- 

The user enters the number of system time units the task sentry will give a task before lowering its 
priority. The default is 60. 



Request 

MEMORY AVAILABLE - 
LINE FREQ. 
TIME SLICING (Y or N) 
TIME SLICE VALUE 
TASK SENTRY (Y or N) 
TASK SENTRY VALUE 
COMMON SIZE 

# OF EXP CHASSIS 
CHASSIS 1 - 4 INT LEVEL 

CHASSIS 5 - 7 



CHASSIS 

DEV NAME 

DEV TYPE 

LEFT CASS/PTP NAME 

RIGHT CASS/PTR NAME 



Table 9-1 . GENTX Prompts 
Range 

Note? 
50 or 60 
YorN 
Note 1 
YorN 
Note 1 

Primarily limited 
by size of available 
memory. 

1-7 

3,4,6,7 
(990/4) 
3,4,6-15 
(990/5 or 990/10) 

3,4,6,7 
(990/4) 
3,4,6-15 
(990/5 or 990/10) 

0-7 

Note 2 

Listed in table 7-3. 

Note 2 

Note 2 



Default 

none 

60 

Y 

1 

N 

60 





None 

None 

None 
None 

None 
None 
None 
None 
None 



Discussed in 
Paragraph 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 
9.3.3.1 



9.3.3.1 



9.3.3.2 
9.3.3.2 
9.3.3.2 
9.3.3.2 
9.3.3.2 



^ 



^^ 



^ 






^ 
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Request 

STATION # 
CRU BASE ADDR 

TILINE ADDR 
ACCESS MODE 
INT LEVEL 



/0^^S. 



INT POSITION 
TIMEOUT COUNT 
# OF DRIVES 
CRU INT LINE 
ENTRY LABEL OF DSR 
ENTRY LABEL OF ROUTINE 
INT BRANCH LABEL 
EXTENSION DATA 

svc# 

ENTRY LABEL 
XOP# 

WORKSPACE LABEL 
ENTRY LABEL 
TASK ID # 

PRIORITY LEVEL 
INITIAL STATE 



Table 9-1. GENTX Prompts (Continued 

Range 

1-127 
0->lFFE 

>F800 - >FBEO 

FILE, RECORD, 
or CHARACTER 

3,4,6,7 
(990/4) 
3,4,6-15 
(990/5 or 990/10) 

0-15 

Note 1 

1 -4 

0-31 

Notes 

Note 3 

Notes 

Notes 

Note 4 

Note 4 

I - 14 
Note 5 
Note 5 

0-OF, 

II -FE 

Note 6 
0-3 





Discussed in 


Default 


Paragraph 


None 


9.3.3.2 


Device de- 


9.3.3.2 


pendent 




Device de- 


9.3.3.2 


pendent 




Listed in 


9.3.3.2 


table 7-3. 




Device de- 


9.3.3.2 


pendent 





None 


9.3.3.2 


Device de- 


9.3.3.2 


pendent 






9.3.3.2 


15 


9.3.3.3 


None 


9.3.3.3 


None 


9.3.3.3 


None 


9.3.3.3 


None 


9.3.3.3 


None 


9.3.3.4 


None 


9.3.3.4 


None 


9.3.3.5 


None 


9.3.3.5 


None 


9.3.3.5 


None 


9.3.3.6 


None 


9.3.3.6 





9.3.3.6 
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Table 9-1. 


GENTX Prompts (Continued) 






Request 


Range 


Default 


Discussed in 
Paragraph 


INITIAL DATA LABEL 


Note 6 


None 


9.3.3.6 


MULTIPLE DYNAMIC TASKS (Y OR N) 


YorN 


N 


9.3.3.6 


# OF DYNAMIC TASKS 


1-256 


None 


9.3.3.6 


# OF PROCEDURES 


0-128 


None 


9.3.3.6 


CONSOLE DEV NAME 


Device name of a 
733 ASR, 733 KSR, 
911 VDT,or913 
VDT 


None 


9.3.3.7 


DEFAULT DISC DEV 


Notes 


None 


9.3.3.7 


DEFAULT PRINT DEV 


Any printing device 


DUMY 


9.3.3.7 


ASSIGN LUNO 


1-FO 


None 


9.3.3.7 


DEV NAME 


Device name 


None 


9.3.3.7 


# OF SPARE DEV LUNO BLOCKS 


0-63 


6 


9.3.3.7 


# OF SPARE FILE LUNO BLOCKS 


0-63, Note 9 


6 


9.3.3.7 


#0F FILE CONTROL BLOCKS 


- 53, Note 9 


6 


9.3.3.7 


#0F DEFAULT BUFFERS 


1-20 





9.3.3.7 


BUFFER SIZE 


2-1024 


None 


9.3.3.7 


#0F GENERAL BUFFERS 


1-50 





9.3.3.7 


BUFFER SIZE 


1 - 1024 


None 


9.3.3.7 


UPPER THRESHOLD - 


1 -99 


None 


9.3.3.8 


LOWER THRESHOLD - 


1-99 


None 


9.3.3.8 


Notes: 









^ 



./-^ 



^?ff%v 



^ 



1. Any positive value that would have practical significance is accepted. The 
actual limit 1 -65,535. 

2. Device names consist of one to four characters, the first of which must be 
alphabetic. 

3. These inputs apply to user-supplied DSRs for non supported devices. 

4. These inputs apply to user-supplied supervisor call routines. 



><*l?!!^v 
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Parameter 

Real Time 
Clock Cycle 

System Time Unit 



Maximum time 
period for a 
Time Slice 

Timeout Counts 



Time Delay 

Do Not Suspend 
periods. 



These inputs apply to extended operation routines. 
These inputs apply to tasks. 
Memory available for use by GENTX. 
Disc device name as it appeared in the name request. 
Not prompted if no diskettes are defined in the system. 
Table 9-2. System Timing Parameters 



Unit of Measurement 

8.3 ms. for 60 Hz. 
10 ms. for 50 Hz. 



Real Time Clock 
Cycles 



System Time Units 

System Time Units 

System Time Units 
System Time Units 



Use 



How Specified 



Used to derive System Time Determined by power line 
Unit and to define maximum frequency, 
time period for a time slice 



Used to define Timeout 
Counts, Time Delays, and 
Do Not Suspend periods. 

Used by Scheduler. 



Used by lOS and DSR to 
detect device errors. 

Used by Scheduler. 

Used by Scheduler. 



6 cycles (50 ms.) for 

60 Hz. 5 cycles (50 ms.) 

for 50 Hz. 

Ehiring system generation. 



During system generation. 



Time Delay supervisor call. 

Do Not Suspend supervisor 
call. 



The next request is as follows: 
^^ COMMON SIZE- 

The user enters the number of bytes to be allocated for the COMMON area of memory, followed by 
a carriage return. The address and size of the COMMON area is supplied to a task in response to a 
Get COMMON Data Address supervisor call. If a TXDS system is being generated, enter at least 170 
(must be an even number). When the user enters a carriage return only, no COMMON area is alloca- 
ted in memory. 

The next request is as follows: 

# OF EXP CHASSIS - 

The user enters the number of CRU expansion chassis connected in the system, a decimal value, 
through 7, followed by a carriage return. When the user enters a carriage return only, GENTX uses 
the default value, 0. The response to this request causes GENTX to request interrupt level assign- 
ments for the expansion chassis. Chassis 1 through 4 share an interrupt level, and chassis 5 through 
^^. 1 share another interrupt level. When the response to this request is 0, expHcitly or by default, the 

next two requests are omitted. 
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When the response to the number of expansion chassis is greater than 0, GENTX prints the 

following request: ""^ 

CHASSIS 1-4 INT LEVEL - 

The user specifies the interrupt level for chassis number 1 through 4, a decimal value followed by a 
carriage return. When the response to the number of expansion chassis is less than 5, the next 
request is omitted. 

When the response to the number of expansion chassis is greater than 4, GENTX prints the 
following request: 

CHASSIS 5-7 INT LEVEL - 

The user specifies the interrupt level for chassis number 5 through 7, a decimal value followed by a 
carriage return. 

9.3.3.2 Supported Peripheral Device Definitions. The peripheral devices connected to the CRU ^*> 

through the CPU chassis are defined as a group. Each device, if it conforms to the standard interrupt 
interface configuration, may be placed on the same interrupt level as another device with like 
constraints. The standard interrupt interface configuration is that CRU bit 1 5 from the base address 
of the device will be "set" when an interrupt occurs. Table 9-3 shows which supported devices may 
share an interrupt level. The user must determine if a special device conforms to this requirement. 

The peripheral devices connected to the CRU through each expansion chassis are also defined as 

a group. The devices on expansion chassis 1-4 share an interrupt level, and the devices on expansion 

chassis 5-7 share another interrupt level. Each device within an expansion chassis has a unique ^*««t^ 

interrupt identifier for use in interrupt decoding. ^ 

Expansion chassis interrupts may also be shared with devices connected to the CRU through the 
CPU if the devices conform to the standard interface configuration. 

The following request begins the peripheral-device definition portion of the definition phase: 
CHASSIS - 

The user enters a digit, through 7, followed by a carriage return, to specify the group of devices '*^, 

to be defined. 

A response of specifies that the subsequent device definitions (until the next chassis request) are 
those of devices connected within the CPU. A response of 1 through 7 specifies that subsequent 
device definitions are those of devices connected through expansion chassis 1 through 7, respective- 
ly. The response to this request must be consistent with the response to the number of the 
expansion-chassis request described previously. A response of a carriage return only terminates the 
device-definition portion of the definition phase. 

GENTX issues the following request to identify the first device to be defined in the chassis: 

DEV NAME - 



The user enters a user-defined device name, consisting of up to four characters, the first of which 
must be alphabetic, the rest may be alphanumeric. The device name is followed by a carriage return. 
GENTX then requests the appropriate device information as described in the following paragraphs. 
When the user enters a carriage return only, GENTX terminates the current chassis definition, and 
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repeats the "CHASSIS -" request for the next chassis. If the user wishes to correct an invalid input 
of a previously defined device, he may enter the name of that device in response to the "DEV 
NAME -" prompt and reenter all the following requests for the device type and CRU base, etc. If a 
user is defining a disc drive, then it is necessary to make the name 3 characters long. 



Following the request for a device name, GENTX issues the following request to identify the type 
of device. The type of device will determine the succeeding questions that will be asked. 

DEV TYPE - 

The user enters a device-type keyword, as listed in table 9-3, followed by a carriage return. If a 
carriage return only is entered, the device definition for the above requested device name is deleted. 



Table 9-3. GENTX Device Keywords 



/^S^^ 
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Device 

Type 

Keyword 


Device 


Default 

Access 
Mode 


Default 

Time-Out 

Count 


Default 
CRU 
Base 


Default 
Interrupt 

Uvel 
(CPU Only) 


Multiple 

Devices per 

Interrupt 

Level 


TTY 


ASR33 Teletype 


RECORD 


8192 





6 


Yes 


ASR 


733 ASR Electronic 
Data Terminal 


RECORD 


8192 





6 


Yes 


KSR 


733 or 743 KSR 
Electronic Data 
Terminal 


RECORD 


8192 





6 


Yes 


K820 


Keyboard/Printer 


RECORD 


8192 





6 


Yes 


LP 


Line Printer 


FILE 


4096 


60i6 


6 


Yes 


FLP 


2230 or 2260 Line 
Printer 


FILE 


4096 


60,6 


6 


Yes 


CR* 


Card Reader 


FILE 


4096 


40i6 


4 


No 


V913 


913 Video Display 


RECORD 


None 


C0i6 


3 


Yes 


COM 


Communications 
Device 


None 


None 


None 


None 


N/R 


FD 


Diskette Drive 


None 


512 


80,6 


7 


N/R 


V911 
MT 


911 Video Display 

Terminal 

979A Magnetic Tape 


RECORD 
FILE 


None 
512 


C0,6 

F88O16 


3 

** Q 


Yes 
Yes 


SD 


Special Device 


RECORD 


None 


None 


None 


U/D 



jl^^m!\ 



N/R - Not Recommended 

U/D - User decision 

*Card reader must have an exclusive interrupt assignment. 

**Magnetic Tape is a TILINE device with a default of >F880. 
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If the user enters one of the first eleven keywords in the table, the device is supported ^^ 

by TX990 Operating System. The last keyword, SD (special device) specifies a nonsupported device. 
Additional GENTX requests for information on nonsupported devices are described in paragraph 
"Defining Other Peripheral Devices". 

When the user enters the keyword V911 or V913 as the device type, GENTX requests the 
following: 

STATION # - 

The user enters a decimal number, 1 through 127, followed by a carriage return. The number is the 
station number used in character mode I/O to the Video Display Terminal (VDT). There is no 
default for station number. 

When the user enters the keyword ASR or TTY, GENTX prints the following requests: the name 
for the left cassette/paper-tape punch, and the right cassette/paper-tape reader: 



LEFT CASS/PTP NAME - 

RIGHT CASS/PTR NAME - 

Following each request, the user enters a user-defined device name, one to four characters, the first 
of which must be alphabetic. The device name is followed by a carriage return. The user assigns the 
cassette or paper-tape units to LUNOs by means of these device names. 

The next request for each TX990 supported device, except a communications or TILINE device, 
is as follows: 

CRU BASE ADDR- 



..^m^ 



^ 



The user enters the CRU base address as a hexadecimal value followed by a carriage return. A 
greater-than character (>) entered as the first character identifies the entry as hexadecimal in the 
range of numbers through IFFEig. The CRU base address is the CRU address shifted one bit 
position to the left (multipled by 2), and must be an even number. On top of each chassis is a chart 
which defines the CRU base for each device. If a carriage return is entered, a standard base will be 
used. Defaults are Usted in table 9-3. ^ 

For TILINE devices the following prompt will appear in place of the CRU BASE ADDR prompt: 

TILINE ADDR- 

The user enters the TILINE address of the device being defined. This value must be a multiple of 
>20 between >F800 and >FBEO, inclusive. 

The fourth request for each device, except diskette or a communications device, is as follows: 

ACCESS MODE- 



^mm^ 
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The user enters one of the following keywords, followed by a carriage return: 

• FILE, for a file-oriented device, or for a 913 or 91 1 VDT that is to be used in either the 
file mode or the character mode, 

• RECORD, for a record-oriented device, or for 913 or 91 1 VDT that is to be used in the 
record mode, as well as character mode (if a VDT is to be used as a system console, it 

must be in RECORD mode). 

• CHAR, for a 9 1 3 or 9 1 1 VDT to be used in the character mode only. 

When the user enters a carriage return only, the default access mode for the specified device appHes. 
Default access mode for devices are listed in table 9-3. 

One of the two formats is used for the fifth request, depending on whether the device is connected 
to the CRU through the CPU or through an expansion chassis. When the device is connected 
through the CPU (CHASSIS - 0), the request is as follows: 

INT LEVEL - 

The user enters a decimal or hexadecimal value followed by a carriage return. The entry represents 
the interrupt level for the device. If a carriage return only is entered, a standard level will be used. 
Defaults are listed in table 9-3. The user must not enter the interrupt level of the CLOCK, which is 
5. When the device is connected through an expansion chassis (chassis entry not equal to zero), the 
request is as follows: 

INT POSITION - 

The user enters a decimal value followed by a carriage return. The entry represents the interrupt 
identifier returned by the expansion chassis when a device generates an interrupt. The interrupt 
identifier is a number in the range of through 15 and is determined by connections within the 
CRU expansion chassis. 

The sixth request for each device, except a diskette or a communications device, is as follows: 

TIME-OUT COUNT - 

The user enters a decimal value followed by a carriage return. The value represents the number of 
system time units to be used as a timeout count for the device. This timeout count will be used by 
the DSR to determine how long to wait on a device before determining that a timeout error has 
occurred. When the user enters a carriage return only, the default value for the specified device 
applies. Default values for devices are listed in table 9-3. Entering a zero specifies no timeout. 

If the device is a diskette or magnetic tape, the following request is made instead of the timeout 
count request: 

# OF DRIVES- 

The user must enter a number in the range of one to four. 
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If the user wishes to define more than one diskette drive he enters the first name and a 2, 3, 4 is ..^^ 

concatenated onto the first three characters of the disc name up to the number entered for # OF ) 

DRIVES— prompt, thus all drives are defined from the first name entered. The names that were 
generated may not be used again, nor may they have already been used. 

If the user wants to generate a system with more than one diskette controller, he can do so by 
entering a different three-character name so that the names generated by concatenating a 2, 3, 4 
are different than the disc names that have already been defined. 

When the device is a supported device, GENTX next repeats the device name request to define 
another device. 

9.3.3.3 Special Device Definition. Special devices are those which are not supported by TI supplied 
modules. When the device type request is printed, the user may enter the keyword SD. GENTX 
requests the same six parameters as for supported devices, then prints the following request: 

CRU INT LINE - 

The user enters a number in the range of zero through 31, followed by a carriage return. The 
number represents the displacement from the base address to the CRU Hne that is set when an inter- 
rupt occurs. 

The next request for a nonsupported device is as follows: 

ENTRY LABEL OF DSR - 

The user enters the entry label of the Device Service Routine (DSR) for the device followed by a ^'^ 

carriage return. The entry point required in response to this request is the entry point for supervisor 
call processing. The user suppHes the DSR for the device when he links the TX990 system together. 

The next request for a nonsupported device is as follows: 

ENTRY LABEL OF ROUTINE - 

The user enters the entry label of the interrupt routine for the device, usually a part of the DSR, 
followed by a carriage return. 

The next request for a nonsupported device is as follows: 

INT BRANCH LABEL - 

The user enters the label of the interrupt branch followed by a carriage return. Typically an inter- 
rupt routine performs processing common to any interrupt for the device, then branches to perform 
processing appropriate to the context of the interrupt. For example, an unsolicited interrupt usually 
requires different processing than the interrupts that occur while performing an I/O operation 
specified in a supervisor call. The label to which the unsoUcited interrupt causes the system to 
branch is supplied in response to the above request. 

The next request for a nonsupported device is as follows: 

EXTENSION DATA - 



n. 



/"•'^'v 
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The user enters a source statement in assembly language, followed by a carriage return. The user 
may enter an exclamation point (!) following each field of the source statement to tab to the 
beginning of the next field. Specifically, entering an exclamation point positions the following 
character at position 8, 13, or 3 1 . 

The source statement will be entered in the source file for TXDATA following the source state- 
ments suppHed by GENTX for the PDT for the device. GENTX repeats the request until the user 
enters a carriage return only, which terminates the definition for the device. Subsequent source 
statements are placed following the initial statement. The group of source statements entered in 
response to this series of requests forms an extension to the PDT that contains device-related data. 
When the user terminates the definition of the device, GENTX repeats the device name request to 
define another device. 

9.3.3.4 Defining User-Supplied Supervisor Calls. When the user has terminated the 
peripheral-device portion of the definition phase, GENTX prints the following request: 

svc#- 

The user enters a hexadecimal number, followed by a carriage return. The number represents the 
call code of a user-supplied supervisor call (XOP level 15). The valid codes begin at 80i6 and extend 
as far as required to include all user-supplied calls. For example, if three supervisor calls are supplied 
by a user, the call codes must be 80i6 , 81 15 , and 82i6 . They may be entered in any order, but must 
all be included. Similarly, if a single supervisor call were supplied, its call code would be 80 15 . When 
the user enters a carriage return only, GENTX omits the next request and terminates the supervisor- 
call portion of the definition phase. 

When the user has entered a supervisor-call code, GENTX prints the following request: 

ENTRY LABEL - 

The user enters the entry label of the supervisor-call code, followed by a carriage return. The user 
must supply the supervisor-call routine when linking the TX990 operating system. GENTX then 
repeats the SVC number request. 

9.3.3.5 Defining Extended Operations. When the user has terminated the supervisor call portion of 
the definition phase, GENTX enters the extended operation portion of the definition phase and 
prints the following request: 

XOP#- 

The user enters a decimal number, through 14, followed by a carriage return. The number 
represents the level of a software implemented extended operation. The user supplies an XOP 
routine for the extended operation. When the user enters a carriage return only, GENTX omits the 
next two requests and terminates the extended operation portion of the definition phase. For 
further details concerning extended operation routines refer to Appendix C. 

When the user enters an XOP number, GENTX prints the following request: 
WORKSPACE LABEL - 

The user enters the label of the workspace of the XOP routine, followed by a carriage return. 
GENTX then prints another request: 

ENTRY LABEL - 
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The user enters the label of the entry to the XOP routine, followed by a carriage return. 

The user must supply the object programs that process the XOP when linking the TX990 Operating 
System. GENTX then repeats the XOP number request. 

9.3.3.6 Defining Tasks. When the user terminates the extended operation portion, GENTX enters 
the task definition portion. During this phase of system definition, GENTX adds to the internal 
table of data from which it will generate the source statements for TASKDF. Both system tasks, 
and user-supplied tasks must be defined at this time if they are to be linked with the new TX990 
Operating System. Table 9-4 shows the task IDs for the system tasks under the "ID" column, the 
priority level of each task is under the "PRIORITY" column, and the label on the first word of each 
task is under the "DATA LABEL" column. Each system task, and its purpose, is described in 
Appendix J. 

Table 9-4. System Task Definition 



/"^^bv 



Task 


ID 


Priority 


Data Label 


FMPl 


>F0 





FMPl 


FMP2 


>F1 





FMP2 


FMP3 


>F2 





FMP3 


FMP4 


>F3 





FMP4 


FUR 


>B 


1 


FUR 


VOLUME 


>C 





VOLUME 


DTASK 


>D 


1 


DIAGTS 


OCP 


>F 


1 


OCP 


CNTROL 


>16 


1 


CNTROL 


STASK 


>10 


1 


STRT 



^ 



The user may select a task ID for his tasks but they must not be the same ID as a system task ID. 
Task IDs l-Fie and FOie -FFig are reserved for system tasks. The task ID will be used to bid the 
task, or to execute the task from OCP. The priority level will define which tasks will use the most 
time slices. Priority level zero is the highest available priority level. The data label is a defined (using 
the assembler directive, DEF) label on the first three words of a task. These words define the initial 
Workspace, Program Counter, and End Action address. A reference (an assembler REF directive) 
will be generated inside the TASKDF module, so that the TX990 Operating System will have the 
information needed to begin execution of that task. 

The following requests are made by GENTX asking for the above information. 

TASK ID # - 

The user enters a number, followed by a carriage return. The number represents the task identifier 
by which the task is identified to the system, and must be less than FF^^ . Identifier 0^6 is ^ssigned 
to the dynamic-task area, and user tasks should be assigned identifiers greater than ;0i6- When the 
user enters a carriage return only, GENTX terminates the task-definition portion of the definition 
phase, and begins requesting information for assigning LUNOs. 

For each task, GENTX prints three requests following entry of the task identifier. The first request 
is as follows: 

PRIORITY LEVEL - 

The user enters a one to four character priority value (0 to 3 or Rl to R127), followed by a carriage 
return. Priority level should be used only for system tasks. 



^ 
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The second request is as follows: 

INITIAL STATE - 
The user enters a value of 0, 1 , 2, or 3. The default is 0. Refer to Table 9-5. 
The third request is as follows: 



INITIAL DATA LABEL- 

The user enters the label on the first word in the task, followed by a carriage return. Then GENTX 
repeats the task ID request. When all tasks have been defined and the user has terminated the 
task-definition portion, GENTX asks if the system is to support multiple dynamic tasks. 

Table 9-5. Initial States 

Value Meaning 

Privileged; not active at initial load of operating 

system, restart, or power restart. 

1 Privileged; active at initial load of operating 

system or restart; not active at power restart. 

2 Privileged; not active at initial load of operating 

system or restart; active at power restart. 

3 Privileged; active at initial load of operating 

system, restart, or power restart. 

The request is as follows: 

MULTIPLE DYNAMIC TASKS (Y OR N) - 

The user should enter Y or N. If the response is N or the default, GENTX proceeds to the Assign 
LUNO phase. If the response is Y, GENTX requests the maximum number of dynamic tasks 
allowed to be in the dynamic task area at one time, as follows: 

# OF DYNAMIC TASKS - 

The user enters a decimal number between 1 and 255, inclusive. Then GENTX requests the 
maximum number of procedures allowed to be installed in the dynamic task area at one time as 
follows: ' 

# OF PROCEDURES - 

The user enters a decimal number between and 127, exclusive. GENTX then proceeds to the 
Assign LUNO phase. 

'^ 9.3.3.7 Information For Assigning LUNOs. The following information is used to generate: names 

' for LUNO assignments; memory blocks that will be reserved for device LUNOs; and file LUNOs and 

memory blocks that will be reserved for communication devices. 
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The following request is made by GENTX asking for the device name of the system console. Most 
of the utilities, and the Operator Communication Package (OCP) interact with the user through the 
system console. The request is as follows: 



DEV NAME - 

The user enters the device name previously assigned to a device. GENTX then repeats the assign 
LUNO request. 

The next request is as follows: 

# OF SPARE DEV LUNO BLOCKS - 

The user enters a decimal number followed by a carriage return. The number represents the number 
of device logical unit blocks to be provided in the system in addition to those numbers assigned 
previously. When the ALUNO OCP command of the File Utility supervisor call is included in a 
TX990 system, there must be logical unit blocks for all LUNOs that will be assigned at one time. 
When the user enters a carriage return only in response to the request, GENTX provides six addi- 
tional blocks. In systems which support multiple dynamic tasks, more blocks may be necessary. 



^m^ 



CONSOLE DEV NAME - 

The user enters the device name (previously assigned) for the system console, followed by a carriage 
return. The device must be either device type ASR, KSR, or VDT. When the device is device type 
VDT, it must have been previously defined for the record mode. The user may enter a carriage 
return only to specify no system console. 

GENTX makes the following request: 

DEFAULT DISC DEV - 

The user must enter the diskette device name (previously defined) as it appeared in the name 
request. The user may enter a carriage return to specify no default disc. The default disc name is 
used when a utility is referring to the system disc; it is also used when no disc name is appended to '^'*^ 

the pathname of a file. 

GENTX makes the following request: 

DEFAULT PRINT DEV - 

The user enters the device name (previously defined) for the system default printers. The device can 

be any printing device. The user may enter a carriage return to specify the Dumy device. The 

device is used by some of the Tl-supplied utilities when no Usting device is specified. It is a required .^ 

parameter in a TX990 Operating System that supports a Terminal Executive Development System. ' 

Next, GENTX prints the following request: 

ASSIGN LUNO - 

The user enters a hexadecimal value, followed by a carriage return. The range of values is 1 through 
EF16 . The value represents a LUNO by which a device is accessed for I/O operations. When the user 
enters a carriage return only, GENTX skips the next request of the definition phase. Otherwise, 
GENTX requests the name of the device to be assigned to the LUNO, as follows: 



^ 
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The next request, if a diskette has been defined, is as follows: 

# OF SPARE FILE LUNO BLOCKS - 

The user enters a decimal number followed by a carriage return. The number represents the number 
of file logical unit blocks to be provided in the system. There must be file logical unit blocks for all 
LUNOs that will be assigned to files at one time. When the user enters a carriage return, GENTX 
provides six additional blocks. 

The next request, if a diskette has been defined, is as follows: 

# OF FILE CONTROL BLOCKS - 

The user enters a number between and 50. The number represents the maximum number of files 
that can be open at any time. If File Management is to be used with TXDS, a minimum of three File 
Control Blocks are required. When the user enters a carriage return, GENTX provides six additional 
blocks. 

The next request is as follows: 

# OF DEFAULT BUFFERS - 

The user enters a decimal number from to 20. If a carriage return is entered, no buffers are 
reserved and GENTX skips the size request. If GENTX accepts the number, it requests the size of 
the buffer in bytes by presenting the following prompt: 

BUFFER SIZE - 

The user must enter a decimal number from two to 1024. 
The next request is: 

# OF GENERAL BUFFERS - 

The user enters a decimal number from to 50. If a carriage return is entered, no buffers are 
^ allocated and GENTX omits the next request and terminates the general buffer portion of the 

^ definition phase. 

If GENTX accepts the number it requests: 

BUFFER SIZE - 

The user enters a decimal number from 1 to 1024 which represents the number of bytes in each 
buffer. GENTX then repeats the GENERAL BUFFER request. The default and general buffers are 
simply reserved areas in the system table area which may be accessed by user tasks via the Get Data 
and Put Data SVCs. 

9.3.3.8 Communication Threshold Definition. If a device name was defined as a communications 
device by entering "COM" for the "DEV TYPE-" request, GENTX requests the communications 
thresholds as follows: 

— ^ UPPER THRESHOLD - 

LOWER THRESHOLD - 



r^' 
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(The user is referred to the Communications Systems Manual for a detailed explanation of ^^^^,„^^^ 

thresholds.) The user enters decimal numbers, from 1 to 99, and the upper threshold must be ^ 

greater than or equal to the lower. If in error, the sequence will be repeated. 

9.3.3.9 Suggestions For Defining Devices. The following request of GENTX are repeated until the 
user enters a carriage return only in response. This allows an indefinite number of each item to be 
defined, as appropriate for the apphcation. These requests are as follows: 

CHASSIS 

svc# 

XOP# 

TASK ID# 

ASSIGN LUNO 

# OF GENERAL BUFFERS 

When the same chassis number is entered by the user in response to a subsequent chassis request, 
additional devices entered following the second entry of the chassis number are added to the group 
originally defined. This allows definition of devices by function or by physical arrangement rather 
than by connection within the computer. That is, in the following example, the line printer and 
card reader are connected through the CPU, and the VDT is connected through expansion chassis 1 : 

CHASSIS - ' 

DEV NAME - LIPR 
DEV TYPE - LP 



DEV NAME - 
CHASSIS - 1 

DEV NAME - GTTY 
DEV TYPE - V913 



DEV NAME - 
CHASSIS - 

DEV NAME - CRDR 
DEV TYPE - CR 



When the same device name, supervisor call number, extended operation number, task identifier, 
or LUNO is entered again, the previously entered information is replaced by the new information, --^ 

redefining the item. To delete a device name, enter the chassis number and the device name. Then ' 

enter a carriage return only in response to the device type request. 
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9.3.4 CONSTRUCTION PHASE. After the last request of the Definition Phase of GENTX, the 
Construction Phase is entered. During the construction phase, GENTX generates source statements 
for TXDATA and TASKDF using the responses entered by the user during the definition phase. 
GENTX prints the following request: 

TASKDF OUTPUT FILE NAME - 

The user may enter the full file name or device name. If the file does not exist it will be created. 

The user may inhibit output of TASKDF by entering a carriage return only. GENTX then prints the 
final request as follows: 

TXDATA OUTPUT FILE NAME - 

The user enters the full file or device name. When the file does not exist it will be created. The 
user may inhibit output of TXDATA by entering a carriage return only. GENTX then terminates, 
bidding the rebid task. 

NOTE 

DXIO output file names must be full pathnames; synonyms are 
not accepted. 



9.3.5 GENTX ERROR MESSAGES. Table 9-6 Hsts the error messages or warnings produced by 
GENTX. 



Error 

*INVALID INPUT* 

*INPUT ERROR* 

*MULTIPLY DEFINED 
INPUT* 

*LUNO ASSIGNED 
TO CONSOLE* 

*INVALID DEV* 

*ASSIGN ERROR* 



*OPEN ERROR* 



*CLOSE ERROR* 



Table 9-6. GENTX Error Messages 
Reason 

Response not valid. 

Response not within range. 

The input has already been pre- 
viously defined. 

User tried to assign LUNO to a 
device other than the console. 



Recovery 

Reenter response. 
Reenter response. 
Reenter response. 



Select a LUNO other than 0. 
Reenter response. 



The device type name was not valid See table 7-3. Reenter response. 



Could not assign LUNO 10 to the 
output device or file. 



Could not open output device or 
file. 

Could not close, or release output 
device of file. 



Release some LUNOs and re- 
execute the task; or an invahd 
device name was entered. Re- 
enter response. 



*STORAGE ALLOC. 
ERROR* 



GENTX table area exhausted. Mem- 
ory area not large enough. 
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9.4 ASSEMBLING THE SOURCE MODULES ^^ 

After termination of GENTX, the user must assemble the two source modules, TXDATA and 1 

TASKDF. Assembly is accomphshed by executing the TXDS Asserhbler, TXMIRA. Each source 
module is assembled separately. 

For detailed instructions for operating TXMIRA consult the TXDS Programmer's Guide. 

9.5 LINKING THE OBJECT MODULES 

After assembhng the two modules it is necessary to use the Object Manager to select the Tl-suppUed 
object modules that support features of the TX990 operating system. Selection of these features is 
made from the object module files residing on the diskette which contains the TX990 parts and an 
object file residing on the system diskette. The files are described below: 

:DSRLIB/OBJ — Object file that contains DSR modules supplied by Texas Instruments; 

:DYNTSK/OBJ - Object file that contains modules to support multiple dynamic tasks; 

:OCPLIB/OBJ — Object file that contains OCP modules supplied by Texas Instruments; ^*^ 

:FMPLIB/OBJ - Object file that contains FILE MANAGEMENT modules supplied by 
Texas Instruments; 

:CNTROL/OBJ - Object file that contains the TXDS control program; 

:TXLIB/OBJ — Object file that contains TX990 modules supplied by Texas Instruments. 

The user must create a file that will contain all the object modules he wishes to link to form the "^^ 

new operating system. This new file will contain modules from each of the object library files. The 
user should refer to table 9-7 to select the modules which support the desired features. The modules 
should be selected from the files in the following order: 

:DSRLIB/OBJ 

:DYNTSK/OBJ 

:OCPLIB/OBJ 

:FMPLIB/OBJ 

:CNTROL/OBJ 

:TXLIB/OBJ 



n 



y?^'>K 
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There is no defined order in which modules must be included, although user-supplied object 
modules and programs must be included before the object module TXEND, in file: TXLIB/OBJ. It 
is logical to place a DSR with the other DSRs, a supervisor call routine with the supervisor call 
routines, and a task with the other tasks. 

After the file has been generated by the Object Manager (OBJMGR), the user must link it with the 
two object modules, TXDATA and TASKDF. TXDATA must be first in the link sequence and 
TASKDF must be second. 

Because many modules which may be incorporated in a customized TX990 system are optional, the 
modules TXEND and OCPEND contain many dummy symbol definitions. When optional modules 
are included, the link editing process results in multiply defined symbol errors, as shown in the 
following: 

SYMBOL MULTIPLY DEFINED *w*W*W*W*W*W*W*W*W*W*W*W*W*W*W* 
SYMBOL = ALRSET , MODULES = 47, 49 

SYMBOL MULTIPLY DEFINED *W*W*W*W*W*W*W*W*W*W*W*W*W**W*W* 
SYMBOL = BADID MODULES = 42, 49 

Such errors do not result in an incorrect link edit. To belsure that the multiply defined symbols are 
not caused by fatal errors, compare the second number given after MODULES in the error message 
to the module numbers given in the link map for: OCPLRT, OCPIOU, OCPEND, or TXEND. 

The following is an example of part of such a link map: 



OCPTAD 


48 


657A 


01F8 


INCLUDE 


01/14/77 


14:07:24 


SDSMAC 


OCPEND 


49 


6772 


0016 


INCLUDE 


09/15/77 


11:26:28 


SDSMAC 


TXEND 


50 


6788 


0142 


INCLUDE 


10/05/77 


13:15:42 


SDSMAC 



If the numbers match, the error is nonfatal and is to be expected. 

After the files have been linked to form a new TX990 operating system, the new object module file 
containing the new TX990 must be defined as the system file by using the System Utility 
(SYSUTL) command "SF". Also, the TXBOOT program must be copied to the diskette by using 
the SYSUTL command "BC". 






9.6 EXAMPLE OF SYSTEM GENERATION 

The materials needed are: 

• The TX990 parts diskette (diskette #1) 

• The TXDS system diskette (one of TXDS system diskettes #2, 3, 4) 

• A scratch disc on which the system can be built. 
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NOTE 

Operator responses to prompts presented on the system console 
are underlined in the following procedure. Prompts are not under- 
lined. 

1. Load diskette #1 (TXPARTS) in diskette drive 2 (right). Load diskette #2, #3, or #4 
(TXDS system) in diskette drive 1 (left). 

2. Load the TX990 Operating System into memory by pressing the following keys on the 
Programmer's Panel. 

a. Halt 

b. Reset 

c. Load 

After the TX990 Operating System is loaded into memory the following message will be 
printed out or displayed on the system console: 

TX990 V.R.E YY.DDD 

MEMORY SIZE (WORDS): 24576 MEMORY AVAILABLE: 16749 

3. Bid TXDS by entering an exclamation point (!) on the terminal. The following display 
will appear on the system console: 

! 

TXDS V.R.E YY.DDD 

PROGRAM: 

4. Load a scratch diskette in drive #1 . 

5. Initialize the scratch diskette by responding to the prompts printed out or displayed on 
the system console as follows: 

TXDS V.R.E YY.DDD 

PROGRAM: :BACKUP/SYS* 

TXBACK V.R.E YY.DDD BACKUP/INITIALIZE 

OUTPUT DISC OR VOLUME NAME? DSC 
THE OUTPUT DISC MUST BE INITIALIZED 
INITIALIZE DSC ?(Y/N) Y 
DISC I.D. ? SCRATCH 
VOLUME NAME ? SCR 

CHECKING DSC 

NOTE 

Section 10.4 describes the Backup Utility in detail. 
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After the diskette has been initialized, the user must bid the System Generation 
(GENTX) Utility by responding to the prompts printed out or displayed on the system 
console as presented below. When no response to a prompt is indicated, the user must 
enter a carriage return/NEW LINE to cause the default-substitute to be used. 



^ 



TXDS 



V.R.E 



YY.DDD 



PROGRAM: : GENTX/SYS* 
GENTX V.R.E YY.DDD 

MEMORY AVAILABLE - 2000 



LINE FREQ. - 
TIME SLICING (Y or N) - 
TIME SLICE VALUE- 
TASK SENTRY (Y or N)- 
COMMON SIZE - 170_ 
# OF EXP CHASSIS - 
CHASSIS - 

a. For ASR System 

DEV NAME - LOG 

DEV TYPE - ASR 

LEFT CASS/PTP NAME - CSi 

RIGHT CASS/PTR NAME - CS2 

CRU BASE ADDR - 

ACCESS MODE - 

INT LEVEL - 

TIME-OUT COUNT - 

b. For 911 System: 

DEV NAME - LOG 
DEV TYPE - V911 
STATION # - i 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 



TX990 SYSGEN 



Take default (table 9-1) 
Take default (table 9-1) 
Take default (table 9-1) 
Take default (table 9-1) 



^ 



Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 



^ 



Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 






For 913 System: 
DEV NAME - LOG 
DEV TYPE - V913 
STATION # - 1 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 



Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 
Take default (table 9-3) 
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d. Resume system generation : 



/SfWK 



j^^f\ 



DEV NAME - DSC 
DEV TYPE - FD 
CRU BASE ADDR - 
INT LEVEL - 
# OF DRIVES -1 

DEV NAME -LP 
DEV TYPE - LP 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 

TIME-OUT COUNT - 

DEV NAME- 
CHASSIS - 

svc#- 

XOP#- 

TASK ID # - >F0 

PRIORITY LEVEL - 0_ 

INITIAL STATE - 

INITIAL DATA LABEL - FMPl 
TASK ID # - >F1 

PRIORITY LEVEL -^ 

INITIAL STATE - 

INITIAL DATA LABEL - FMP2 
TASKID#->B 

PRIORITY LEVEL -J_ 

INITIAL STATE - 

INITIAL DATA LABEL -FUR 
TASK ID # - >C 

PRIORITY LEVEL - 

INITIAL STATE - 

INITIAL DATA LABEL - VOLUME 
TASK ID # - >D_ 

PRIORITY LEVEL ^ 

INITIAL STATE - 

INITIAL DATA LABEL - DIAGTS 
TASK ID # - >^ 

PRIORITY LEVEL ^J_ 

INITIAL STATE - 

INITIAL DATA LABEL - OCP 
TASK ID # - >16 

PRIORITY LEVEL ^ 

INITIAL STATE - 

INITIAL DATA LABEL - CNTROL 
TASK ID #- 

MULTIPLE DYNAMIC TASKS (Y or N)- 
CONSOLE DEV NAME - LOG 
DEFAULT DISC DEV - DSCT 
DEFAULT PRINT DEV - LP 



Generate floppy 

Take default (table 9-3) 
Take default (table 9-3) 
Two drives: DSC and DSC2 



Take default (table 9-3) 
Take default (table 9-3) 
6 on 91 1 system or 
take default (table 9-3) 
Take default (table 9-3) 
Terminate sequence 



TMPl 

Take default (table 9-1) 

FMP2 

Take default (table 9-1) 

FUR 

Take default (table 9-1) 

Volume name support 

Take default (table 9-1) 

Diagnostic Task 

Take default (table 9-1) 

Add in OCP 

Take default (table 9-1) 

TXDS CONTROL 

Take default (table 9-1) 

Terminate sequence 
Take default (table 9-1) 
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ASSIGN LUNO-1 

DEV NAME - LOG ^ 

ASSIGN LUNO - Terminate sequence 

# OF SPARE DEV LUNO BLKS - Take default (table 9-1 ) 

# OF SPARE FILE LUNO BLKS - Take default (table 9-1) 

# OF FILE CONTROL BLOCKS - Take default (table 9-1 ) 

# OF DEFAULT BUFFERS - None 

# OF GENERAL BUFFERS- Take default (table 9-1 ) 

# OF GENERAL BUFFERS - Terminate sequence 
TASKDF OUTPUT FILE NAME - :TASKDF/SRC Note 1 
TXDATA OUTPUT FILE NAME - :TXDATA/SRC Note 2 

END TX990 SYSGEN 

7 Select the Tl-supplied object modules to support the desired TX990 Operating System 
features and copy them to the scratch diskette by responding to the prompts as follows: 

TXDS V.R.E YY.DDD ^ 

PROGRAM: :OBJMGR/SYS* 

OBJMGR V.R.E YY.DDD OBJECT MANAGER 

OUTPUT FILE: DSC:TXPART/OBJ 
INPUT FILE: DSC2:DSRLIB/0BJ 
REWIND INPUT FILE? y_ 

FPYDSR ? C_ .-*. 

DSR911 ? _S_ Cif911VDT ^ 

DSR913 ? S_ Cif913VDT 

DSR733 ? C_ SifnoASR733 

LPDSR ? C_ 
FLPDSR ? D_ 

Notes: 

1 . Constructs a source program for the task definitions and puts them in the file: TASKDF/SRC. 

2. Constructs a source program for the TX990 Operating System data structures and puts them ^ 
in the file :TXDATA/SRC. 



^ 
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INPUT FILE: DSC2:OCPLIB/OB.T 
REWIND INPUT FILE? Y_ 
OCPTSK ? A. 
END-OF-FILE 



INPUT FILE: DSC2 
REWIND INPUT FILE? 


:FMPLIB/OBJ 
Y 




VOLUME 


? C 








TXFMP 1 


? C 








TXFMP2 


? C 








TXFMP3 ? S 
TXFMP4 ? S 
TXFMP ? A 
END-OF-FILE 






No DSC3 
No DSC4 
Rest of file 


INPUT FILE: 


DSC2: 


CNTROL/OBJ 





All ofOCP is included, 
without multiple dy- 
namic task support 



REWIND INPUT FILE? X 
CNTROL ? C_ 
END-OF-FILE 



J^^ 



r^ 



INPUT FILE: 


DSC2:TXLIB/0BJ 




REWIND INPUT FILE? Y 




TXROOT 


? 


c 






TITTCM 


? 


c 






EVENTK 


? 


s 






IMGLDR 


? 


c 






CRTPRO 


? 


c 






STA913 


? 


s 




Cif913VDT 


SVC 913 


7 


s 




Cif913 VDT 


STA911 


? 


s 




Cif911 VDT 


SVC911 


? 


s 




C if 911 VDT 


lOSUPR 


? 


A 




Rest of file 


END-OF-FILE 








INPUT FILE: 


* 




END OBJECT MANAGER 





^^ 
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8. Remove diskette #1 from drive #2 and load diskette #2 or #3 or #4 in drive #2. 

9. Assemble TASKDF and TXDATA for linking with the selected Tl-supplied modules as 
follows: 



y'^P^^^. 



10. 



TXDS V.R.E YY.DDD 




PROGRAM: :TXMIRA/SYS 


Assemble TXDATA 


INPUT: :TXDATA/SRC 




OUTPUT: :TXDATA/OBJ.:TXDATA/LST 


Put listing on diskette 


OPTIONS: CLS 




TXMIRA V.R.E YY.DDD 


ASSEMBLER 


TXDS V.R.E YY.DDD 




PROGRAM: >10 

INPUT: ;TASKDF/SRC 
OUTPUT: :TASKDF/OBJ,:TASKDF/LST 
OPTIONS: CLS 


Assemble TASKDF 
Put listing on diskette 


TXMIRA V.R.E YY.DDD ASSEMBLER 





Link the system as follows: 

TXDS V.R.E YY.DDD 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 

TXLINK V.R.E YY.DDD 



:TXLINK/SYS 

:TXDATA/OBJ, :TASKDF/OBJ.:TXPART/OBJ 

:NEWSYS/SYS,:NEWSYS/LST 

CLITX990 

LINK EDITOR 



1 1 . Remove diskette #2 or #3 or #4 from drive #2 and load diskette #1 in drive #2. 

12. Mark the newly-linked system as the system file as follows: 

TXDS V.R.E YY.DDD 
PROGRAM: :SYSUTL/SYS* 

SYSUTL V.R.E YY.DDD SYSTEM UTILITY 

OP: SF, :NEWSYS/SYS. TE. 



^?*^^^ 



^ 



TXDS V.R.E 
PROGRAM: 



YY.DDD 



/<?«W|tfiy 
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/•^^ 13. Load into memory the new TX990 Operating System by pressing the HALT, RESET, 

and LOAD keys on the Programmer Panel: 

TX990 V.R.E YY.DDD 

MEMORY SIZE (WORDS): 24576 AVAILABLE: 14631 

14. Bid TXDS via OCP by entering an exclamation point (!) to bid OCP; then respond to the 
period (.) prompt as follows: 

! 

T ex. 16. TE. (Execute TXDS) 

TXDS V.R.E YY.DDD 

15. Remove diskette #1 from diskette drive #2 and insert diskette #2 into drive #2. 

1 6. Copy TXDATA, TASKDF and LINK MAP LISTINGS to LP as follows: 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXCCAT/SYS 
:TXDATA/LST.:TASKDF/LST.:NEWSYS/LST 

LP 
RO 



TXCCAT V.R.E YY.DDD COPY/CONCATENATE 
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SECTION X 
DISKETTE/DISC BACKUP AND INITIALIZE PROGRAM 

10.1 INTRODUCTION 

The Diskette Backup and Initialize Utility Program (BACKUP) may be used for two functions: 
initializing a diskette and copying (backing up) files to a diskette. It allows the user to: back up an 
entire diskette, partially backup a diskette, simply initialize a new diskette, or partially backup 
several diskettes to a single diskette. 

The backup utihty can copy and verify files, or copy or verify files separately. Errors are Usted at 
the system console. Files that have no data are identified by warning messages. 

Before writing to the output diskette, BACKUP checks to see if it is initialized. If not, it requests 
the user to initiaUze the diskette, prompting for required information. When copying files, BACKUP 
generates contiguous files on the output diskette, thus reducing fragmentation of disk space. 

BACKUP also initiaUze the directory and allocation bit map on the output diskette, and can 
designate a system file if requested by the user. 

10.2 LUNOs AND THEIR USES 

LUNOs 5, 6, 10 and 11 are used. All LUNOs are assigned by BACKUP and are released when 
BACKUP terminates. LUNO 5 is assigned to the output diskette. LUNO 6 is assigned to the input 
diskette. LUNO 10 is assigned to the input file, and LUNO 1 1 is assigned to the output file. 

10.3 OPERATING PROCEDURE 

To load the Diskette Backup Utihty and place it in execution under TX990, perform the following 
steps using the OCP: 

1 . Place the object module for BACKUP in the appropriate device and ready the device. 

2. Enter the appropriate command to load the module. For example: 

LP,CS2. Loads the object code from cassette drive 2. 

LP,DSC:BACKUP/SYS Loads the object code from diskette file 

DSC:BACKUP/SYS. 

3. Enter the appropriate command to execute the task. 

EX,10.TE. Execute the program just loaded. If the backup 

utility was linked to the system, the user need only to 
execute the task ID assigned to it at that time. 

To place the backup utility under execution using the Terminal Executive Development System, 
perform step 1 above. If the TXDS Control Program is not executing, bid task 16i6 if OCP is active. 

EXECUTE, 16.TE. 
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TXDS lists its heading and asks for input as follows: 

TXDS V.R.E YY.DDD 

PROGRAM: DISC: BACKUP/SYS* 

The user enters DSC: BACKUP/SYS* in response to the prompt: "PROGRAM:" The object code in 
the diskette file, DSC: BACKUP/SYS, is loaded and executed by the control program. Alternatively, 
the user can enter the cassette drive name. 

PROGRAM: CSl* 

Then the object code on cassette drive 1 is loaded and executed. 

10.4 USER INTERACTION WITH THE BACKUP UTILITY 

When BACKUP is executed, it displays a heading: 

TXBACK V.R.E YY.DDD BACKUP/INITIALIZE ^ 

After the heading is displayed, BACKUP requests the output diskette name: 

OUTPUT DISC OR VOLUME NAME? 

The user enters either a device name or the volume name of the diskette to be initialized or copied 
to. 



■~) 



NOTE 

A user response of "*" to any BACKUP prompts terminates the 
utility. A user response of "&" to any prompt returns BACKUP to 
the above prompt, "OUTPUT DISC OR VOLUME NAME?". 

After the user specifies the output diskette, BACKUP checks it to see if it is initiaUzed. If so, 
BACKUP prompts the following: 

DELETE ALL FILES ON XXXX? (Y/N) 

where XXXX is the output device name. The user enters Y if he desires to delete any preexisting 
files on the diskette without regard to any file protection. BACKUP clears all directory entries and 
resets the allocation bit map on the diskette. If the user enters N, BACKUP prompts the 
"INITIALIZE XXXX? (Y/N)" message as described below. 

NOTE 

The delete all option will delete all files including delete protected 
files. 

If the output diskette is not initialized, BACKUP displays the following: 

THE OUTPUT DISC MUST BE INITIALIZED 

If the diskette must be initialized, or the user response to the "DELETE ALL FILES" message was 

N, BACKUP prompts the following: "*^ 

INITIALIZE XXXX? (Y/N) 
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where XXXX is the output device name. If the user answers Y, the diskette is initialized. BACKUP 
prompts the message: 

DISCI.D. ? 

The user must enter a 1 to 32 character title for the diskette. The title is displayed by the SYSTUL 
Map Disc (MD) command. The following message is then displayed: 

VOLUME NAME ? 

The user may enter a 1 to 4 character volume name. The volume name will be used to access files on 
the diskette if volume name support is included in the user's customized TX990 Operating System. 
The volume name should not be the same as a device name. If the user enters only a carriage return, 
no volume name is defined for the diskette. Diskette initialization takes about four minutes. 

In order to copy files to a diskette without destroying all of the files on the diskette, the user must 
respond N to both the "DELETE ALL FILES" and "INITIALIZE" prompts. 

After the diskette is initialized, erased, or left intact, the user may copy and/or verify the files on 
any diskette. BACKUP prompts the following two messages, in order: 

COPY FILES? (Y/N) 
VERIFY FILES? (Y/N) 

If the user responds with a Y to either prompt, BACKUP requests the pathname of the files to be 
copied/verified, as follows: 

INPUT PATHNAME? 

Valid responses must have one of the following formats. 

NULL/CARRIAGE RETURN ENTIRE DISKETTE 



VOL 
VOL:FILE/ 

:FILE/ 

VOL/EXT 

/EXT 

VOL:FILE/EXT 
VOL:FILE 
: FILE/EXT 
:FILE 



ENTIRE DISKETTE 

ALL FILES ON THE DISKETTE OR VOLUME WITH 
THIS FILE NAME 

ALL FILES ON DEFAULT DISKETTE WITH THIS FILE 

NAME 

ALL FILES ON THE DISKETTE OR VOLUME WITH 
THIS EXTENSION 

ALL FILES ON DEFAULT DISKETTE WITH THIS 
EXTENSION 

ONLY THIS FILE 

ONLY THIS FILE 

THIS FILE FROM THE DEFAULT DISC 

THIS FILE FROM THE DEFAULT DISC 
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where 



VOL = DISKETTE NAME OR VOLUME NAME 

FILE = FILE NAME 

EXT = FILE NAME EXTENSION 



If the output diskette already contains a file with the same name as one of the input files, the 
existing file is deleted and the copied file replaces it. After the specified files are copied and/or 
verified, BACKUP repeats the sequence with the "COPY FILES" prompt. 

When the user responds N to both the "COPY FILES" and "VERIFY FILES" prompts, BACKUP 
prompts the user to designate a system file. A system file is the image of a TX990 system which 
may be booted (eg. :SYSASR/CMP). To insure that the file is on the output diskette, the diskette 
name is also prompted, as follows: 

SET SYSTEM FILE? DSC2 
where DSC2 is the value given by the user in response to the "OUTPUT DISC" prompt. 

The user may then enter the name of a file on the output diskette which is to be the system file. If 
only a carriage return is entered, no system file is designated. 

After the "SET SYSTEM FILE" prompt, BACKUP returns to the "OUTPUT DISC OR VOLUME 
NAME" prompt. The utility may be terminated by a response of "*" to any prompt. 

When BACKUP terminates, it displays the following message: 

BACKUP & INITIALIZE UTILITY ENDED 

1 0.5 ERROR MESSAGES AND RECOVERY 



^ 



^ 
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Error 

The OUTPUT DISC IS 
NOT USABLE. BACKUP 
UTILITY ABORTED. 



Reason 

Bad diskette 



Recovery 

Get another diskette. 



pathname DOES NOT 
VERIFY. 

pathname WAS EMPTY. 



Bad copy 



A file was created on the input 
file but was never used. 



Rerun the backup utility. 






DISC NAMES CANNOT 
BE THE SAME. 

THE OUTPUT DISC 
MUST BE INITIALIZED. 

pathname WAS UNSUC- 
CESSFULLY OPENED. 



User entered same name for input 
and output disc names. 

Output diskette has never been 
initialized. 

Disc was offline or diskette 
was full. 



Reenter the disc names. 



Execute the diskette 
initialization program. 

Ready the disc. 



^ 
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Error 

COULD NOT GET 
MEMORY. BACKUP 
UTILITY ABORTED. 



Reason 

There is not enough memory 
to run the backup utility. 



Recovery 



'r^ 



pathname HAD AN I/O 
ERROR, CODE nn. 

THE INPUT DISC HAS 
A BAD DIRECTORY RECORD. 
THE FILES IN THAT RECORD 
WERE NOT COPIED. 



nn is the error code; see error 
appendix I. 

There is a diskette 
flaw in that 
record. 



Correct problem. Rerun 
backup utility. 

None. 



^' 



THE OUTPUT DISC HAS 
A BAD DIRECTORY 
RECORD. THE OUTPUT 
DISC IS NOT USABLE. 



There is a Diskette 
flaw on the output 
diskette. 



Disregard the diskette. 



DISC I/O ERROR CODE NN. 



nn is the error 
code; see 
Appendix I — I/O 
Error Codes. 



Correct error and 
retry. 



yj^^^^v 



FILE NOT FOUND 



STATUS CODE NN 



The system file 
does not exist. 



nn is the error 
code; see Appendix 
I - I/O Error Codes. 



Select another 
file as the system 
file. 

Correct error and 
retry. 






NOTE 



The pathname parameter will be filled in with the actual pathname of the file. 
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SECTION XI 
OBJECT MANAGER (OBJMGR) UTILITY PROGRAM 

11.1 INTRODUCTION 

The Object Manager (OBJMGR) Utility Program is used to collect object modules from several 
different diskette or cassette files and combine them into a single output file. The ability to do so is 
especially necessary when preparing to Unk all of the modules of a customized TX990 Operating 
System, since the TXDS Linking UtiHty can only accept up to three input files. 

11.2 LUNOs 

The OBJMGR Utility Program uses LUNO 0, LUNO 4, and LUNO 5. The system console, which is 
assigned to LUNO 0, is used by the OBJMGR Utility Program to request operator input 
information. LUNO 4 is used to read the input file, and LUNO 5 is used to write the output file. 
(^^ Both LUNO 4 and LUNO 5 are assigned and released by the OBJMGR Utility Program. 

11.3 LOADING OBJMGR 

OBJMGR executes using the TX990 Operating System in conjunction with the OCP module, or 
with the TXDS Control Program, or using the DXIO, release 3.2 Operating System. The following 
paragraphs describe how to load and execute OBJMGR under each operating system. 



11.3.1 LOADING OBJMGR USING THE TX990 OPERATING SYSTEM AND OCP. Load the 
program as follows: 

1 . After loading the OCP in accordance with the procedure itemized in the section in this 
manual entitled Operator Communication Package, observe the printout or display on the 
system console of the period (.) prompt. 

2. Place the object module for OBJMGR in either the cassette or diskette drive and ready 
the device. 

3. Using the LP (Load Program) command, load the OBJMGR object module from a 
cassette or diskette by using one of the following indicated methods: 

• LP,CS1,3 Load OBJMGR at priority level 3 when the object 

module is on the cassette in cassette drive 1 . 

• LP,DSC:OBJMGR/SYS. Load OBJMGR from the diskette in diskette drive 1. 

4. Enter the EX (Execute) command to execute OBJMGR and terminate OCP as follows: 

EX,10.TE. 

5. Observe the following printout or display on the system console when OBJMGR begins 
execution: 

OBJMGR V.R.E YY.DDD OBJECT MANAGER 
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11.3.2 LOADING OBJMGR USING THE TX990 TERMINAL EXECUTIVE DEVELOPMENT 
SYSTEM. Load the program as follows: 

1 . Place the object module for OBJMGR in either the cassette or diskette drive and ready 
the device. 

If the TXDS control program is not active enter an "!" and observe the following display: 

TXDS V.R.E YY.DDD 

PROGRAM: 

2. When the OBJMGR object module is in cassette drive 1, enter "CSl*" in response to the 
prompt, as follows: 

PROGRAM CSl* 

When the OBJMGR object module is on a diskette file called :OBJMGR/SYS, enter the 
following: 

PROGRAM: :OBJMGR/SYS* 

3. Observe the following printout or display on the system console when OBJMGR begins 
execution: 

OBJMGR V.R.E. YY.DDD OBJECT MANAGER 

OUTPUT FILE: 



11.3.3 LOADING AND EXECUTING OBJMGR USING DXIO, RELEASE 3.2. Perform the 
following steps on a DXIO release 3.2 system: 

1. Place the OBJMGR object module in some sequential media which is readable by DXIO. 
If the module is on cassette, place it in a cassette drive. If the module is on a diskette file, 
use the TXDX conversion utility available under DXIO to convert the object module file 
to a DXIO file. 

2. Install the object module as a task, using the DXIO IT command: 

IT PF = .SPROGA, TN = OBJMGR, OBJ = <acnm> 

where <acnm> is the DXIO access name of the file or device which contains the object 
module. 

3. Execute the object manager, using the DXIO XTS command. 

XTS TN = OBJMGR 

4. Upon execution, OBJMGR displays the following message: 

OBJMGR V.R.E YY.DDD OBJECT MANAGER 



/<*^V 



^ 
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11.4 OPERATOR INTERACTION 

After the initial heading is displayed, the object manager requests the following information: 



OUTPUT FILE: < pathname of a sequential file or device> 
INPUT FILE: < pathname of a sequential file or device> 
REWIND INPUT FILE? 



{n} 



'IDT of an object module"? ( C 

S 
I 

R 
A 
D 

r^ NOTE 

If an "*" is entered in response to any prompt, OBJMGR writes an 
end-of-file to the output file, closes the file, releases all LUNOs and 
terminates. If an "&" is entered, OBJMGR performs all of the above 
except terminate; it then restarts with the "OUTPUT FILE" prompt. 

The first prompt made by OBJMGR is the following: 

OUTPUT FILE: 

The user must enter a complete pathname for a sequential device or file. There are no defaults. 
DXIO users must not use synonyms. The object modules selected by the user in later steps are 
written to this pathname. 

The next prompt is the following: 

INPUT FILE: 

f^^ The user must enter the name of a sequential file or device which contains object modules to be 

edited onto the output file. In addition to modules on this input file, the user may insert new 
modules from other files. 

After the input file pathname is entered, OBJMGR prompts the following: 

REWIND INPUT FILE? 

The user must answer either Y (yes, rewind the input file) or N (do not rewind the file). 

After the input file is ready, OBJMGR reads the first record, and displays the IDT (see the 
Assembly Language Programmer's Guide) for that module, followed by a question mark. The user 
may then choose to include or exclude that module from the output file, or to insert modules from 
other files, by entering one of the following action commands: 

>™sK ^ ~ ^^py ^^^ object module 

f^ S — skip the object module 

I — insert object modules from other files 
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R — replace this module with modules from other files 

(combination of S and I) 
A - copy all remaining object modules in the input file 
D - done with this input file; leaves the file positioned 

at the current IDT for future use. 

The Copy (C) command causes the object manager to copy the module with the displayed IDT to 
the output file. 

The Skip (S) command causes OBJMGR to skip the module with the displayed IDT without 
copying it. 

The Insert (I) command allows the user to insert modules from another file (the insert file) onto the 
output file, before the module with the displayed IDT. After the I command is given, OBJMGR 
prompts the "INPUT FILE" and "REWIND" messages. The user enters the new file, and Y or N, 
and OBJMGR reads the first record of the new input file and displays the IDT of the first object 
module. The user may enter any of the action commands except I or R. After the user enters a 
Done (D) command, OBJMGR skips several lines and displays a Une of asterisks, followed by the 
IDT that was displayed when the Insert command was entered. If an end-of-file on the insert file is 
read, an "END-OF-FILE" message is displayed, followed by the IDT that was displayed before the 
Insert command. The user may then enter any command. 

The Replace (R) command causes OBJMGR to skip the object module with the displayed IDT, and 
then insert modules from another file (the replace file). After skipping the original module, the 
Replace command executes exactly like the Insert command. 

The All (A) command causes the object manager to copy all of the remaining object modules in the -^ 

input file to the output file, and then resume execution at the "INPUT FILE" prompt. 

The Done (D) command causes OBJMGR to backspace the current file one record (so that the IDT 
which was displayed will be displayed next time the file is opened without rewind). If D is issued 
while processing a Replace or Insert command, OBJMGR resumes prompting of IDTs on the 
original input file. If D is issued for the input file, execution is resumed by prompting for a new 
"INPUT FILE". 

n.5 ERROR MESSAGES 

Table 11-1 shows the error messages which may be returned by OBJMGR. ^ 
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Error Message 

CAN'T ASSIGN I/O 



/^^\ 



INPUT ERROR 



CAN'T OPEN I/O, 
TERMINATING 



INVALID IDT RECORD 



n 



INPUT ERROR, 
RETRY? 



>^f!^^ 



OUTPUT FILE ERROR, 
TERMINATING 



EOF EMBEDDED IN 
OBJECT MODULE 



INVALID COMMAND 
C = COPY, S = SKIP, 
R = REPLACE, I = INSERT, 
D = DONE, A = ALL 



Table 11-1. Error Messages 
Description 

Attempt to assign LUNO 
for input or output was 
unsuccessful. 



I/O error during keyboard entry. 



Error during open operation for 
input or output. 



First record of object module 
does not contain identifier. 



Error while reading input file. 



Error while writing output file. 



An end-of-file record has been 
detected in object module. 



Invahd response to request. 



Recovery 

Check device name, and enter 
correct name. If system capacity 
for active LUNOs has been reached, 
release a LUNO that is no longer re- 
quired. The user may terminate 
Object Manager and attempt to 
assign the LUNO with an ALUNO 
command to obtain a more 
specific error message. 

Try again. If error persists, check 
input device and interface. 

Object Manager terminates. 
Obtain correct object module or 
add proper first record and restart 
Object Manager. 

Object Manager terminates. Obtain 
correct object module or add 
proper first record and restart 
Object Manager. 

Enter N to use the record as read. 
Enter Y to backspace and reread 
the record. When record is a card, 
user must remove card from output 
stacker and place it in input hopper. 
Enter a carriage return to terminate. 

Object Manager terminates. Correct 
the problem and restart Object 
Manager. 

Object Manager terminates. Obtain 
correct object module or remove 
misplaced record and restart 
Object Manager. 

Enter correct response. An 
asterisk terminates OBJMGR, and 
an ampersand (&) restarts it. 
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SECTION XII 
LIST80/80 (LIST80) UTILITY PROGRAM 

12.1 LIST80/80 

The LIST80/80 utility program copies 80-character records from one device or file to another. 
Optionally, LIST80/80 adds carriage control characters for displaying or printing. All files must 
previously have been created and all files and devices must previously have been rewound. 
LIST80/80 can be run from OCP control only and cannot be run using the TXDS Control Program. 

12.1.1 LOAD AND EXECUTING LIST80/80. To execute LIST80/80, place the object code in the 
appropriate device and perform the following steps: 

NOTE 

When LIST80/80 is linked into the Operating System during system 
generation, step 1 does not apply. 

1. Enter a command to load LIST80/80 in the dynamic task area. The following are 
examples of commands to install LIST80/80: 

LP,CS1,3. Load task LIST80/80 at priority level 3 when the 

object module is on cassette unit 1 . 

LPR0G,CR,3. Load task LIST80/80 at priority level 3 when the 

object module is in the card reader. 

LP,:LIST80/SYS,3. Load task LIST80/80 at priority level 3 when the 

object module is in the disc file DCS:LIST80/SYS. 

2. Assign LUNO lOjg to the input device. The following example applies when the input 
device is Cassette Unit 2. (The cassette must have been written in the line mode with 
records that contain 80 or fewer characters.) 

ALUNO,10,CS2. 

3. Assign LUNO 11 15 to the output file. The following example applies when the output 
file is DSC2:S0URCE/SRC. 

ALUN0,1 1,DSC2:S0URCE/SRC. 

4. Enter the following command to execute LIST80/80 and terminate OCP. 

EXECUTE,10.TE. 

NOTE 

When LIST80/80 is linked into the system during system genera- 
-^fc^ tion, the task identifier assigned during system generation is used 

{ instead of 10 in the command in step 4. 
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5. LIST80/80 displays a title and part number heading, as shown: 

LIST80/80 V.R.E YY.DDD LIST80/80 UTILITY 

6. LIST80/80 reads the records from the input device, adds carriage control characters, 
and writes the records to the output device. 

7. When LIST80/80 finishes, a message is displayed on the LOG. 

LIST80/80 TERMINATED 

When the output device is a cassette unit, LIST80/80 does not add carriage control characters. 
An alternative command may be entered in step 4, as follows: 

EXECUTE, 10,FFFF.TE. 

When the Execute command is entered in this form (or with any nonzero value instead of FFFF), 
LIST80/80 does not add carriage control characters to the output record, regardless of the output "^^ 

device. 

12.1.2 LIST80/80 ERROR MESSAGES. LIST80/80 prints two error messages. One error message 
prints as follows: 

ERROR DETECTED ON OPEN OF LUNO 10 OR 1 1 

The possible reasons for this error are: 

• LUNO 10 assigned to an inappropriate device. 

• LUNO 1 1 assigned to an inappropriate device. 

• An error other than busy was returned by the OPEN supervisor call. 

The following error message is printed when an unsuccessful read operation occurs on LUNO 10: 

READ ERROR ON LUNO 10. 
The following error message is printed when an unsuccessful write operation occurs on LUNO 10: 

WRITE ERROR ON LUNO 1 1 . 



y^fma^ 
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SECTION XIII 
DISKETTE DUMP (DSKDMP) UTILITY PROGRAM 

13.1 INTRODUCTION 

The Diskette Dump Utility (DSKDMP) Program allows users to load, dump and modify FD800 
Floppy Disc diskettes on an allocation unit (AU) basis. (Refer to Section IV of this manual for 
a description of the allocation unit and its application to file management.) The utility can be 
executed from either OCP or TXDS. 

In addition to the diskette, a V91 1 or V913 Video Display Terminal is required. 

13.2 LUNOs 

Diskette Dump uses Video Display Terminal (VDT) station number 1, LUNG 4 and LUNG 1. 
It uses VDT station number 1 to display sectors to the user and accept commands from the user. 
It assigns LUNG 4 internally to the floppy-disc drive whose diskette is being dumped, loaded, or 
modified. 

The utility uses LUNG 1 when the print directive (P) is entered. Therefore, the user must assign 
LUNG 1 before the print directive is exercised. 

13.3 LOADING PROCEDURES 

To load the Diskette Dump Utility and execute it using GCP, perform the following steps by 
entering commands at the keyboard of the system console. 

1. Place the object module for Diskette Dump in the appropriate device and ready the 
device. 

2. Enter a command to install Diskette Dump in the dynamic task area. The following are 
examples of load program (LP) commands to install Diskette Dump: 

LP,CS1. Load Diskette Dump at priority level 3 when the object module 

is Cassette Unit 1 . 

LP,CR. Load Diskette Dump at priority level 3 when the object module 

is in the Card Reader. 

3. Assign LUNG 1 to a printing device if the print directive is to be exercised. The following 
is a sample command : 

AL,1 ,LP. Assign LUNG 1 to the line printer. 

4. Enter a command to execute Diskette Dump and terminate GCP, as follows: 

EXECUTE, lO.TE. 

If Diskette Dump was linked into the system at system generation, the load program command is 
not entered and the operand of the execute command (EXECUTE) is the task identifier assigned to 
Diskette Dump when the system was generated. 
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To initiate execution of the Diskette Dump utility using the Terminal Executive Development 

System perform step 1 above, followed by the steps below: "^^ 

1 . Bid TXDS control program when OCP is not active by entering "!". Otherwise, enter "!" 
to bid OCP and enter "EX,16.TE." to bid TXDS control program. 

2. The TXDS control program displays a heading and prompts for input as follows: 

TXDS V.R.E YY.DDD 

PROGRAM: 

3. Enter :DSKDMP/SYS* in response to the prompt as follows: 

PROGRAM: :DSKDMP/SYS* 

13.4 OPERATING PROCEDURES 

Upon execution, an initial mask is displayed on the station number 1 VDT with the cursor 
positioned to the first field of the command line. ^ 

The following shows the initial VDT mask: 

DSKDMP V.R.E YY.DDD DISKETTE DUMP/LOAD UTILITY 

00-OF 

10-lF 

20-2F 

30-3F 

40-4F -^ 

50-5F ' 

60-6F 

70-7F 

DISC: AUNO: SECTOR: 

The cursor is positioned under the first space after DISC:. The user now must enter, in the proper 
field of the command line, the disc drive name, AU number and sector number which is to be dis- 
played on the VDT. To advance from one field of the command line to the next, the user either 
enters the maximum number of characters allowed in the field or presses the TAB key. To return ^^ 

to a previous field, the user presses the NEW LINE/RETURN key. For example, if the cursor was 
positioned at the SECTOR: field and the user wished to return to the DISC: field, the user would 
press the NEW LINE/RETURN key twice. 

Each time data is entered in a field, the utility validates the data. If the data is not correct, the 
message WRONG! is displayed in the lower-right-hand corner of the VDT screen. Before the user 
may advance from one field to the next, vaUd data must be entered in the field from which the 
user wishes to advance. The following is a Hst of restrictions on the values for each of the command 
line fields: 

DISC: Requires a one- to four-character disc-drive name. This name is determined at 

system generation time. 

AUNO: Requires a one- to three-digit decimal number. The range of AU numbers is 

to 332. Leading zeros are not required. Hitting the TAB key without 
entering a number causes a zero to be entered. ^^ 

SECTOR: Requires a one-digit decimal number. The range of the sector number is to 5. 

Hitting the TAB key without entering a number causes zero to be entered. 
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After the user has entered the disc-drive name, AU-number, and sector-number parameters, the 
utility displays the sector on the VDT, indicates the mode of the data being displayed (either 
ASCII, EBCDIC, or hexadecimal and positions the cursor, as indicated by the blinking light, to 
accept utility directives. The following is an example of the VDT display: 



T 



DISC: DSC 

00 -OF 
10 -IF 
20-2F 
30-3F 
40-4F 
50-5F 
60-6F 
70-7F 



A.U. 

F M 

D S 

O C 

T X 

G E 



DSKDMP V.R.E YY.DDD DISKETTE DUMP/LOAD UTILITY 
5 SECTOR: U MODE: ASCII 



P L 

R L 

P L 

L I 

N T 



I B 
I B 
I B 
B 
X 






B J 


00 06 


W 


00 


00 


00 





B J 


00 ♦ 


W 


00 


00 


00 





B J 


00 I 


W 


00 


00 


00 





B J 


00 5D 


W 


00 


00 


00 


s 


Y S 


00 80 


W 


00 


00 


00 



r 



The user can now enter one of the Blinking Cursor one-character directives indicated in table 13-1. 
(^^ The following paragraphs define these functions. 

13.4.1 INCREMENT SECTOR NUMBER (I). This directive increments the number of the sector 
being displayed and causes the new sector to be displayed. If the new sector number goes beyond 5, 
the first sector (sector 0) of the next AU is displayed. 

13.4.2 DECREMENT SECTOR NUMBER (D). This directive decrements the number of the sector 
being displayed and causes the new sector to be displayed. If the new sector number goes lower 
than 0, the last sector (sector 5) of the previous AU is displayed. 

13.4.3 PRINT DISPLAY (P). This directive causes the displayed sector to be written to the hard- 
copy device assigned to LUNG 1. After P is input, the following message is displayed: 

PRINT? (Y/N) 

The user types a Y on the VDT and the output is performed. Typing an N indicates to the utiUty 
that the user decided not to print the display and so the printing process is not started. 

13.4.4 SET DATA MODE TO ASCII (A). This directive causes the sector data to be interpreted 
(^^ and displayed in ASCII format. 

13.4.5 SET DATA MODE TO EBCDIC (E). This directive causes the sector data to be interpreted 
and displayed in EBCDIC format. 
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Table 13-1. Diskette Dump Utility Directives 



Directive 


Function 


I 


Increment sector number 


D 


Decrement sector number 


P 


Print display 


A 


Set data mode to ASCII 


E 


Set data mode to EBCDIC 


H 


Set data mode to Hexadecimal 


M 


Modify displayed sector data 



,.<<m!^ 



New-Line-Position cursor to SECTOR: field. ^ 

13.4.6 SET DATA MODE TO HEXADECIMAL (H). This directive causes the sector data to be 
displayed in hexadecimal format. 

Figure 13-1 shows the same sector displayed in the three different modes: ASCII, EBCDIC and 
hexadecimal. The displayed sector is grouped into 8-bit (byte) fields. Therefore on each line of the 
display there are 16 bytes of the sector displayed. On the hexadecimal (hex) display each byte is 
represented by two hexadecimal characters. On the ASCII and EBCDIC displays, each byte is ^"^^ 

represented as either a two-character upper-case ASCII or EBCDIC character (first character is 
blank), a two-character lower-case ASCII or EBCDIC character (first character is a "."), or if the 
byte of data has no ASCII or EBCDIC representation, the two-character hexadecimal value is 
displayed. 

13.4.7 MODIFY DISPLAYED SECTOR DATA (M). This directive allows a user to modify the 
displayed sector data. After the user enters the directive, the following message is output: 



^ 



MODIFY? (Y/N): 

If the user types N, the utility stops the modify operation. If the user types Y, the cursor positions 
to the first byte displayed for the sector (upper-left-hand corner of the display). The user may move 
the cursor about with the "arrow" keys up, down, right and left. Hexadecimal characters may be 
entered by entering the two character hex value. An ASCII character may be entered by typing 
a blank followed by the desired ASCII character. An EBCDIC character may be entered by typing 
a period followed by the desired EBCDIC character. After all changes have been made, the "new 
line/return" must be pressed. This causes the following message to be output: 

RE-WRITE DISC?: 

If the user types N, the modify operation is terminated without modifying the data on the disc. 
If the user types Y, the modified sector is written to disc. 

13.4.8 POSITION CURSOR TO SECTOR:. Pressing NEW LINE/RETURN key causes the cursor 
to position to the SECTOR: parameter field. Pressing NEW LINE/RETURN key three more times 
causes Diskette Dump to terminate. It outputs the following message on the VDT screen. ^"^ 

**** END OF PROGRAM **** 

1 ^"^ Digital Systems Division 
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DISC: DSC2 


A.U.: 


5 


SECTOR: 


MODE: 


HEX 




















00 -OF 
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4D 


50 


4C 


49 


42 


20 


4F 


42 


4A 


00 


06 


57 


00 


00 


00 


10 - IF 


44 


53 


52 
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49 


42 


20 


4F 


42 


4A 


00 


2A 


57 


00 


00 


00 


20 -2F 


4F 


43 


50 
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49 


42 


20 


4F 


42 


4A 


00 


49 


57 


00 


00 


00 


30 -3F 


54 


58 


4C 


49 


42 


20 


20 


4F 


42 


4A 


00 


5D 


57 


00 


00 


00 


40 -4F 


47 


45 


4E 


54 


58 


20 


20 


53 


59 


53 


00 


80 


57 


00 


00 


00 


50 -5F 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


2E 


60 -6F 


2E 
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2E 
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2E 
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Figure 13-1. Three Modes of Sector Display 
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13.5 ERROR MESSAGES 

The following error messages can be generated during execution of DSKDMP: 



WRONG! 



DISC ERROR 



An attempt was made to input invalid parameters, command directives, 
or to perform an invalid operation or LUNOs were not available to the 
task. 

Either a disc hardware error occurred or an attempt was made to read 
a nonexistent AU. 
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APPENDIX A 
LIST OF SUPERVISOR CALLS 
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Table A-1 lists the supervisor calls available to the user. The call code, the hexadecimal value to be 
placed in byte of the supervisor call block (SCB), is shown in the first column. The name of the 
supervisor call is listed in the second column, followed by the byte-size of the supervisor call block 
in the third column. The fourth column contains an X if the (SCB) must be word-aligned. The fifth 
column contains a brief description of the results of the supervisor call. For a detailed description 
of each supervisor call, refer to Sections III and IV in this manual. It should be noted that "R" 
signifies "Workspace Register" in table A-1 below. 



Code Supervisor Call 

OO16 I/O 

01 16 Wait for I/O 

02 16 Time Delay 



OA 



Table A-1 . Supervisor Calls 
Byte Size Aligned 



Note 1 
4 



03,6 


Get Date and Time 


4 


04,6 


End of Task 


1 


05,6 


Bid Task 


Note 2 


06,6 


Unconditional Wait 


1 


07,6 


Activate Suspended 
Task 


3 


08,6 


Character Input 


3 


09,6 


Do Not Suspend 


2 



16 Convert Binary to Decimal 8 



X 
X 



Result 



Note 1 



Calling task suspended pending com- 
pletion of I/O operation defined in 
SCB at the address in bytes 2 and 3 of 
SCB. 

Calling task suspended for number of 
system time units in bytes 2 and 3 of 
SCB. 

Date and time returned in binary form 
in five-word area at address in bytes 2 
and 3 of SCB. 

Calling task terminated. 

Task (ID in byte 2 of SCB) is bid. 

Calling task suspended unconditionally. 

Suspended task (ID in byte 2 of SCB) is 
activated. 

Input character from station keyboard 
(ID in byte 2 of SCB); place in RO. 

Inhibit suspension of calling task by sys- 
tem for number of system time units de- 
termined by contents of byte 1 of SCB. 

Convert binary value in RO to decimal 
ASCII characters; place in bytes 2 
through 7 of SCB. 
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Code 

OB16 



OC 



16 



OD 



16 



OEi 



OFi 



10 



11 



16 



16 



12 



16 



13 



15 



16 



16 



I61 



17 



16 



18 



16 



lA 



16 



Table A-1. Supervisor Calls (Continued) 



Supervisor Call 

Convert Decimal to Binary 



Convert Binary to Hexa- 
decimal 



Convert Hexadecimal to 
Binary 



Activate Time Delay Task 

Abort I/O on Specified 
Luno 

Get COMMON Data 
Address 

Change Priority 
Get Memory 



Release Memory 
File Management 

End of Program 
Get Parameters 



Conditional Character 
Input 



VDT Utility 



Byte Size Aligned 



12 



12 



X 



X 



Result 



Convert decimal ASCII characters in 
bytes 2 through 7 of SCB to binary 
value; place in RO. 

Convert binary value in RO to hexadeci- 
mal ASCII characters; place in bytes 2 
through 5 of SCB. 

Convert hexadecimal ASCII characters 
2 through 5 of SCB to binary value 
place in RO. 

Time delay task (ID in byte 2 of SCB) is 
activated. 

I/O in progress with LUNO in byte 1 is 
terminated. 

Address of COMMON area in R9; size 
inR8. 

Priority of calling task changed to value 
in byte 1 of SCB. 

The number of 32-byte blocks of 
memory requested in bytes 2 and 3 of 
the SCB is allocated and the address of 
the first block is placed in R9. 

Included for compatibility with DXIO; 
performs no operation. 

The file management operation defined 
in the SCB (Assign or Release LUNO) is 
performed. 

Operation bids the rebid task which is 
usually the TXDS Control Program. 

Task parameters are placed in bytes 2 
through 5 of SCB. 

Bit 2 of Status Register set to one and 
character from station keyboard (ID in 
byte 2 of SCB) placed in RO, or bit 2 set 
to zero if no character available. 

The VDT I/O operations defined in the 
SCB are performed. (Write or read 
characters, open or close I/O, position 
cursor or tab.) 



^ 
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Table A-1 . Supervisor Calls (Continued) 



Code 


Supervisor Call 


Byte Size 


Aligned 


IB16 


Return COMMON 


1 




IC16 


Put Data 


12 


X 


1D,6 


Get Data 


12 


X 


IE16 


Abort I/O on Specified 
SCB 


4 


X 


2O16 


Get Own ID 


2 




21 16 


Get System Table 


4 


X 


23,6 


Make Task PrivUeged 


2 




2E,6 


Get Own ID 


2 




3Ai6 


Enable or Disable 
Event Key 


10 


X 


3Bi6 


Initialize Date and 
Time 


6 


X 



Result 



Included for compatibility with DXIO; 
performs no operation. 

Put message on message queue. 

Get message from message queue. 

Abort I/O on specific SCB. 

Task ID returned in byte 1 . 

System table address returned in bytes 2 and 3. 

Makes the task privileged. 

Task ID returned in byte 1 . 

Enable or Disable Event Key. 



Initializes the system time and 
date values in the TX990 data 
area. 



'n 



Notes: 






1. Size of SCB for File Management supervisor call includes 2-byte SCB and 10- or 14- or 22-byte SCB. I/O 
operation defined in SCB is performed. 

2. Size of SCB for Bid Task supervisor call is 3, 6, or 8 bytes. When two optional parameter words are included, 
8 bytes are required; when a single optional parameter word is included, 6 bytes are required; otherwise, 3 
bytes are required. 
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APPENDIX B 
DEVICE CHARACTER SETS 

The TX990 Operating System supports ASCII I/O operations with all devices. This section Hsts the 
character sets for the devices and the end-of-record and end-of-file sequences for the devices. 

Table B-1. 911 Video Display Tenninal Character Set 
End-of-Record - NEW LINE (CR) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


1 


31 


B 


42 


J 


21 


2 


32 


C 


43 


n 


22 


3 


33 


D 


44 


# 


23 


4 


34 


E 


45 


$ 


24 


5 


35 


F 


46 


% 


25 


6 


36 


G 


47 


& 


26 


7 


37 


H 


48 


> 


27 


8 


38 


I 


49 


( 


28 


9 


39 


J 


4A 


) 


29 


: 


3A 


K 


4B 


* 


2A 


> 


3B 


L 


4C 


+ 


2B 


< 


3C 


M 


4D 


> 


2C 


= 


3D 


N 


4E 


- 


2D 


> 


3E 





4F 




2E 


? 


3F 


P 


50 


/ 


2F 


@ 


40 


Q 


51 





30 


A 


41 


R 


52 
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Character 


Hexadec 


S 


53 


T 


54 


U 


55 


V 


56 


w 


57 


X 


58 


Y 


59 


Z 


5A 


[ 


5B 


\ 


5C 


] 


5D 


A 


5E 


_ 


5F 



Table B-1. 91 1 Video Display Terminal Character Set (Continued) 
I Character Hexadecimal Character 



a 


61 


b 


62 


c 


63 


d 


64 


e 


65 


f 


66 


g 


67 


h 


68 


i 


69 


J 


6A 


k 


6B 


1 


6C 


m 


6D 



u 

V 

w 



Hexadecimal 

6E 
6F 
70 

71 
72 
73 
74 
75 
76 
77 
78 
79 
7A 



/^^^^^ 



^ 



^ 



Notes: 

1 . Entering left arrow (-^) backspaces the cursor and deletes the character in the buffer. 

2. Entering right arrow (-^) moves the cursor one column to the right and places the character in the buffer. 

3. Entering ERASE FIELD moves the cursor to the first character of the line, clears the characters on the line, and 
deletes those characters in the buffer. 

4. Entering RETURN positions the cursor at the first character of the next line and terminates the record. 



^ 
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Table B-1. 911 Video Display Terminal Character Set (Continued) 

Notes (Continued): 

5. Table B-1 applies to the record and file modes only. 

6. The maximum buffer size for record or file mode VDT is 82 characters. 

7. Pressing the space bar stops output in record mode. Pressing the space bar again restarts output. 

8. Pressing the ESC key terminates output. 

9. Entering a tab stores 09 le in the buffer and writes a space to the screen. 
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Table B-2. 913 Video Display Terminal Character Set 
End-of-Record - NEW LINE (C/R) 



z"*^ 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


6 


36 


L 


4C 


1 


21 


7 


37 


M 


4D 


n 


22 


8 


38 


N 


4E 


# 


23 


9 


39 





4F 


$ 


24 




3A 


P 


50 


% 


25 


J 


3B 


Q 


51 


& 


26 


< 


3C 


R 


52 


5 


27 


= 


3D 


S 


53 


( 


28 


> 


3E 


T 


54 


) 


29 


7 


3F 


U 


55 


* 


2A 


@ 


40 


V 


56 


+ 


2B 


A 


41 


w 


57 


J 


2C 


B 


42 


X 


58 


- 


2D 


C 


43 


Y 


59 


• 


2E 


D 


44 


Z 


5A 


/ 


2F 


E 


45 


[ 


5B 





30 


F 


46 


\ 


50 


1 


31 


G 


47 


] 


5D 


2 


32 


H 


48 


A 


5E 


3 


33 


I 


49 


- 


5F 


4 


34 


J 


4A 






5 


35 


K 


4B 
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Table B-2. 913 Video Display Terminal Character Set (Continued) 

Notes: 

1 . Pressing the backspace arrow ('^) moves the cursor one column to the left and deletes the character in the buffer. 

2. Pressing the forward space arrow (-^) moves the cursor one column to the right and places the character in the 
buffer. 

3. Entering DELETE LINE moves the cursor to the first character of the line, clears the characters on the line, and 
deletes those characters in the buffer. 

4. Entering NEW LINE positions the cursor at the first character of the next line and terminates the record. 

5. Entering TAB causes 09 le to be stored in the buffer and a space to be written on the screen. 

6. Table B-2 appUes to the record and file modes only. 

7. The maximum buffer size for record or file mode VDT is 82 characters. 

8. Pressing the space bar stops output in record mode. Pressing the space bar again restarts output. 

9. Pressing the RESET key terminates output. 
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Table B-3. 733 or 743 Data Terminal Character Set 

End-of-Record - C/R (applies to keyboard and cassette input only) 

End-of-file - DC3 (applies to keyboard and cassettes only) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


7 


37 


N 


4E 


j 


21 


8 


38 





4F 


// 


22 


9 


39 


P 


50 


# 


23 




3A 


Q 


51 


$ 


24 


i 


3B 


R 


52 


% 


25 


< 


3C 


S 


53 


& 


26 


= 


3D 


T 


54 


> 


27 


> 


3E 


U 


55 


( 


28 


1 


3F 


V 


56 


) 


29 


@ 


40 


W 


57 


* 


2A 


A 


41 


X 


58 


+ 


2B 


B 


42 


Y 


59 


> 


2C 


C 


43 


Z 


5A 


- 


2D 


D 


44 


[ 


5B 




2E 


E 


45 


\ 


5C 


/ 


2F 


F 


46 


] 


5D 





30 


G 


47 


A 


5E 


1 


31 


H 


48 


- 


5F 


2 


32 


I 


49 


' 


60 


3 


33 


J 


4A 


a 


61 


4 


34 


K 


4B 


b 


62 


5 


35 


L 


4C 


c 


63 


6 


36 


M 


4D 


d 


64 



..^•^^ 
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Character 



g 
h 
i 

J 
k 

1 

m 



Table B-3. 733 or 743 Data Terminal Character Set (Contmued) 



Hexadecimal 

65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 



Character 


Hexadecimal 


n 


6E 





6F 


P 


70 


q 


71 


r 


72 


s 


73 


t 


74 


u 


75 


V 


76 



Character 


Hexadecimal 


w 


77 


X 


78 


y 


79 


z 


7A 


1 


7B 


J 


7C 


I 


7D 


^s^ 


7E 



Notes: 

Keyboard: 






Printer: 



Cassette Input: 



/^iP^^^S^ 



1. BS character (OSie) is returned to printer as LF and BS. Deletes most recently entered 
character in buffer if an input operation is in progress. 

2. HT character (09i6) is returned to printer as space. Character is placed in buffer. 

3. LF character (OAie) is returned to printer as LF character is placed in buffer. 

4. CR character (ODig) is returned to printer as CR, and character is not placed in buffer. 
Character terminates the record. 

5. DCS character (ISig) is not stored in buffer. When DCS is first character of record, the 
record is an end-of-file record. 

6. ESC character (IBie), when entered during output, terminates output with a write error. 

7. DEL character (TFig) is returned to printer as a line feed and carriage return. Character 
deletes current input record if an input operation is in progress. 

8. Maximum buffer size is 83 characters. 

1 . BS character (08 le) results in a backspace operation. 

2. HT character (09 le) results in printing a space. 

3. LF character (OAie) results in a Hne feed operation. 

4. FF character (OCig) results in eight line feed operations. 

5. CR character (ODig) results in a carriage return operation. 

6. End-of-record occurs when specified number of characters have been printed. 

7. Maximum buffer size is 83 characters. 

1 . The characters LF (OAig) and DEL (7Fi6) or the character DEL at the beginning of a record 
are ignored. The first valid character of the record is the character following the DEL. 

2. The characters HT (09i6), FF (OCig), BEL (07 ig), and BS (08i6) are stored in the user's 
buffer. 

3. The character ETB (Hie) is stored in the user's buffer as a CR (ODig). 
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Table B-3. 733 or 743 Data Terminal Character Set (Continued) 

Notes: (Continued) 

4. The character DC3 (13 15) as the first character of a record indicates an end-of-file 
record. The system returns end of fQe status after positioning the tape at the be- 
ginning of the next record. The DC3 is not stored in the buffer. 

5. The character CR (ODi^) indicates end-of-record, and is not stored in the buffer. 

6. Maximum buffer size is 83 characters. 

Cassette Output: 1. The end of block character sequence is CR (ODig) LF (OAxg) DC4 (Hje) DEL (VFi^). 
The end of file character sequence is DC3 (13i6) CR DC4 DEL. These characters are 
supplied by the system, not by the user. 

2. The characters HT (09i6), FF (OC16), BEL (07 15), and BS (0815) are written unchanged. 

3. The character CR (OD16) is translated to ETB (17i6) and written. 

4. The character DC3 (13i6) may be placed within a record, but may not be the first 
character of a record other than the end of file record. 

5. End-of-record occurs when specified number of characters have been written. 

6. Maximum buffer size is 83 characters. 
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Table B-4. Card Reader Character Set 



Character 


Hexadecimal 


Row Punches 


Character 


Hexadecimal 


Row Punches 


NUL 


00 


12-0-9-8-1 


$ 


24 


11-8-3 


SOH 


01 


12-9-1 


% 


25 


0-84 


STX 


02 


12-9-2 


& 


26 


12 


ETX 


03 


12-9-3 


f 


27 


8-5 


EOT 


04 


9-7 


( 


28 


12-8-5 


ENQ 


05 


0-9-8-5 


) 


29 


11-8-5 


ACK 


06 


0-9-8-6 


* 


2A 


11-84 


BEL 


07 


0-9-8-7 


+ 


2B 


12-8-6 


BS 


08 


11-9-6 


J 


2C 


0-8-3 


HT 


09 


12-9-5 


- 


2D 


11 


LF 


OA 


0-9-5 


. 


2E 


12-8-3 


VT 


OB 


12-9-8-3 


/ 


2F 


0-1 


FF 


OC 


12-9-84 





30 





OR 


OD 


12-9-8-5 


1 


31 


1 


SO 


OE 


12-9-8-6 


2 


32 


2 


SI 


OF 


12-9-8-7 


3 


33 


3 


DLE 


10 


12-11-9-8-1 


4 


34 


4 


DCl 


11 


11-9-1 


5 


35 


5 


DC2 


12 


11-9-2 


6 


36 


6 


DC3 


13 


11-9-3 


7 


37 


7 


DC4 


14 


9-84 


8 


38 


8 


NAK 


15 


9-8-5 


9 


39 


9 


SYN 


16 


9-2 




3A 


8-2 


ETB 


17 


0-9-6 


j 


3B 


11-8-6 


CAN 


18 


11-9-8 


< 


3C 


12-84 


EM 


19 


11-9-8-1 


= 


3D 


8-6 


SUB 


lA 


9-8-7 


> 


3E 


0-8-6 


ESC 


IB 


0-9-7 


? 


3F 


0-8-7 


FS 


IC 


11-9-84 


@ 


40 


84 


GS 


ID 


11-9-8-5 


A 


41 


12-1 


RS 


IE 


11-9-8-6 


B 


42 


12-2 


US 


IF 


11-9-8-7 


C 


43 


12-3 


SPACE 


20 


NO PUNCHES 


D 


44 


124 


I 


21 


12-8-7 


E 


45 


12-5 


w 


22 


8-7 


F 


46 


12-6 


# 


23 


8-3 


G 


47 


12-7 
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Table B-4. Card Reader Character Set (Continued) 

Row Punches < 

12-8 

12-9 

11-1 

11-2 

11-3 

114 

11-5 

11-6 

11-7 

11-8 

11-9 n 6E 12-11-5 "^ 

0-2 

0-3 

04 

0-5 

0-6 

0-7 

0-8 

0-9 

12-8-2 

0-8-2 

11-8-2 

11-8-7 

0-8-5 

8-1 

12-0-1 

12-0-2 

12-0-3 



Character 


Hexadecimal 


H 


48 


I 


49 


J 


4A 


K 


4B 


L 


4C 


M 


4D 


N 


4E 





4F 


P 


50 


Q 


51 


R 


52 


S 


53 


T 


54 


U 


55 


V 


56 


w 


57 


X 


58 


Y 


59 


Z 


5A 


[ 


5B 


\ 


5C 


] 


5D 


A 


5E 


- 


5F 


\ 


60 


a 


61 


b 


62 


c 


63 



acter 


Hexadecimal 


Row Punches 


d 


64 


12-04 


e 


65 


12-0-5 


f 


66 


12-0-6 


g 


67 


12-0-7 


h 


68 


12-0-8 


i 


69 


12-0-9 


J 


6A 


12-11-1 


k 


6B 


12-11-2 


1 


6C 


12-11-3 


m 


6D 


12-114 


n 


6E 


12-11-5 





6F 


12-11-6 


P 


70 


12-11-7 


q 


71 


12-11-8 


r 


72 


12-11-9 


s 


73 


11-0-2 


t 


74 


11-0-3 


u 


75 


11-04 


V 


76 


11-0-5 


w 


77 


11-0-6 


X 


78 


11-0-7 


y 


79 


11-0-8 


z 


7A 


11-0-9 


1 


7B 


12-0 


1 


7C 


12-11 


\ 


7D 


11-0 




7E 


11-0-1 


DEL 


7F 


12-9-7 
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Table B-5. Line Printer Character Set 
Giancter Hexadecimal Character Hexadecimal 

9 39 R 52 

3A S 53 

; 3B T 54 

< 3C U 55 

3D V 56 

> 3E W 57 

? 3F X 58 

@ 40 Y 59 

A 41 Z 5A 

B 42 [ 5B 

C 43 \ 5C 

D 44 ] 5D 

E 45 A 5E 

F 46 _ 5F 

G 47 '60 

H 48 a 61 

f^^ 30 I 49 b 62 

J 4A c 63 

K 4B d 64 

L 4C e 65 

M 4D f 66 

N 4E g 67 

4F h 68 

P 50 i 69 

"f*^ 8 38 Q 51 j 6A 



n 



haracter 


Hexadecimal 


Space 


20 


1 


21 


tt 


22 


# 


23 


$ 


24 


% 


25 


& 


26 


» 


27 


( 


28 


) 


29 


* 


2A 


+ 


2B 


) 


2C 


- 


2D 


• 


2E 


/ 


2F 





30 


1 


31 


2 


32 


3 


33 


4 


34 


5 


35 


6 


36 


7 


37 


8 


38 



r> 1 1 
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Table B-5. Line Printer Character Set (Continued) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


k 


6B 


r 


72 


y 


79 


1 


6C 


s 


73 


z 


7A 


m 


6D 


t 


74 


\ 


7B 


n 


6E 


u 


75 


1 


7C 





6F 


V 


76 


1 


7D 


P 


70 


w 


77 


~ 


7E 


q 


71 


X 


78 


DEL 


7F 
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Notes: 



1 . Models 306 and 588 printers respond to the following control characters: 

BS (08i6) results in a backspace operation. 

HT (09i6) results in a single space. 

LF (OAie) results in a line feed operation. 

CR (ODie) results in a carriage return operation. 

FF (OCie) results in a form feed operation. 

BEL (07i6) results in a tone signal. 

The character SO (OEie) results in character elongation for the line of characters following the SO. Elongation 
doubles the width of the characters, and a line of elongated characters contains one-half the number of 
characters on a normal line; i.e., 40 or 66. 

2. Models 2230 and 2260 printers respond to the following control characters: 

HT (09 16) results in a single space. 

LF (OAie) results in a line feed operation. 

CR (ODig) results in a carriage return operation. 

FF (OC 16 ) results in a form feed operation. 

Only characters 20i6 through 5Fi6 are supported. All other graphics character codes are converted to blanks. 
The codes 5Ei6 and 5Fi6 produce the characters t and ^, respectively. 

3. The Model 810 printer responds to the various control characters and control character sequences as follows: 

CR (OD) Carriage return causes data in the printer buffer to be printed. The print head is left in its current 

position. 

LF (OA) Line feed causes data, if any, in the printer buffer to be printed and advances the paper one 

line. 

BEL (07) Bell resuhs in a tone signal. 

BS (08) Backspace results in a backspace operation. 
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/^^ Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

HT (09) Horizontal Tab causes spaces to be entered in the printer buffer up to the next horizontal tab 
position. 

DCl (1 1) Select selects the printer, enabling it to receive data. 

DC2, N (12, N) Tab to line causes the paper to advance to the Hne specified by N. N must be greater than 
current line position. 

DC3 (13) Deselect deselects the printer, preventing it from receiving data. 

DEL (7F) Delete clears the printer buffer of all characters. 

NUL (00) Null terminates the tab setting sequence (see below), otherwise it is ignored. 

DC4, N (14, N) Tab to column causes the carriage to advance to the column specified by N. N must be 
greater than the current column position, otherwise it will be ignored. 

f^ ESC, 1 , Nl , N2, N3 , . . ., NK, NUL (IB, 1 , Nl , N2, . . ., NK, 00) Set vertical tabs clears all existing tabs 

and sets new tabs at lines Nl , N2, . . ., and NK. 

ESC, 2, N (IB, 2, N) Set form length sets the form length used by the FF command to N. 

ESC, 3, Nl , N2, . . ., NK, NUL (IB, 3, Nl , N2, . . ., NK, 00) Set horizontal tab clears all existing horizontal 
tabs and sets new tabs at locations Nl , N2, . . ., NK. 

ESC, 4 (IB, 4) Sets paper drive system to 6 lines per inch. 

ESC, 5 (IB, 5) Sets paper drive system to 8 lines per inch. 

ESC, 6 (IB, 6) Sets print size to 10 characters per inch. 

f ESC, 7 (IB, 7) Sets print size to 16.5 characters per inch. 

ESC, 8, M (IB, 8, M) Stores vertical format data, either vertical tab locations or form length (see note 1), 
into vertical format channel M (non-volatile internal printer memory). 

ESC, 9, M (IB, 9, M) Recalls vertical format data from vertical format channel M into working memory. 
This command has the same effect as issuing a set vertical tabs command or set form length. 

ESC, : , N (1B,3A,N) Converts printer from 132 position printer to one of N positions where 

2<N<127. 

ESC, ; (IBi 3B) Returns printing to normal 132 positions. 

All of the preceding commands may not apply if the printer does not have the particular option needed to execute 
the command. If the printer does not have the required hardware to execute the command, the command will be 
ignored. 

N, Nl , N2, etc, used in the ESC commands represent 7 bit binary numbers. If the parity option is selected on the 
printer, correct parity must be supplied here also. M is an ASCII number, where 1<M<8. Commas are used in 
the preceding commands for separators only and are not to be included in the commands. 
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Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

SO (OE) SO causes elongated character printing. The elongated character must be sent as the first character 

of the line and must precede each line printed in elongated characters. Also, with elongated print only 66 

characters per line are allowed. If more than 66 characters are sent, the excess are printed on the next 

line as standard, nonelongated characters. 

VT (OB) Vertical Tab causes data, if any, in the buffer to be printed and advances the paper to the next 

vertical tab location or top of form, whichever comes first. If no vertical tabs are set, a VT command causes 

the paper to advance to the top of the form. 

FF (OC) Form Feed causes data, if any, in the printer buffer to be printed and advances the paper to top 

of the next form. At Power Up, the lines per form is 66. 

For a write ASCII operation, the line printer DSR filters all control characters in the range O-lFie , except the 
following: 

Bell 

Backspace 

Horizontal tab (converted to a space) 

Line feed 

Form feed 

Carriage return 

Elongated character 

(ignored by the Hne printer) 

If the user wishes to use the full control character set, the Write Direct (OC) operation must be used. No characters 
will be filtered on a Write Direct (OC) operation. 

NOTE 

The two options, vertical forms control and form length, are mutually exclusive. 
The printer may have either option but not both. 

4. The Model 820 KSR responds to the various control characters and control character sequences as follows: ^ 

BS (0Bi6) Backspace moves printhead one character space in reverse direction. BS does not modify any 
character previously stored in buffer memory. BS is ignored if the printhead is at left margin. 



BEL 


07 


BS 


08 


HT 


09 


LF 


OA 


FF 


OC 


CR 


OD 


SO 


OE 


SI 


OF 



,.-'«'«%. 
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Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 



CR (ODie) Carriage return moves printhead to left margin when printing in undirectional mode or initiates 
printing of next Une in bidirectional mode. CR also advances paper one Une space if the appropriate "new 
line" feature is configured. CR also will cause CR and LF to be transmitted if the appropriate feature is 
configured. CR on input always terminates a record and is not placed in the user buffer. 

FF (OCie) Form feed advances paper and positions printhead to the top left margin on the next form. 

LF (OAig) Line feed advances paper one line space. If LF advances paper beyond bottom margin paper 
slews to next top margin. LF will also cause carriage return if the appropriate new line feature is configured. 

BEL (OTig) Bell sounds audible alarm. 

HT (09i6) The Horizontal tab, if the Non-volatile Forms Control (NVFC) option is installed, advances 
f^ the printhead at high speed to next tab stop. With no tabs set between the present print position and the 

right margin, a horizontal tab is treated as a carriage return/line feed so that the next printable character 
will normally appear in the first print position of the next line. In bidirectional mode the printhead does 
not move, but data in the buffer is manipulated so that the printed output will have the same appearance 
as in undirectional mode. 

HT is ignored if the NVFC option is not installed. 

VT (OBie) Vertical tab, if the NVFC option is installed, advances paper to next vertical tab stop while 
^^ the printhead remains in the same column. If no tab stop is set between the present line and bottom 

margin, the paper advances to the next top margin and the printhead remains in the present column posi- 
tion. 

VT is ignored if the NVFC option is not installed. 

SI (OFie) Shift in selects standard (US ASCII) character set for printing. SI is ignored if an alternate charac- 
ter set option is not installed. 

SO (OEig) Shift out selects alternate character set, such as APL or Katakana, for printing. SO is ignored if 
f^ an alternate character set option is not installed. 

ENQ (05 16) Enquiry triggers the answerback memory (ABM) if an ABM is programmed. In half duplex 
operation, transmission of ENQ or receipt of ENQ, followed by loss of carrier (circuit CF off), initiates 
a line turnaround if and only if an ABM is programmed. 

EOT (04i6) End of transmission uses a disconnect character if the appropriate configuration is selected; 
otherwise, it is ignored. 

ESCJ(1B, 4A) Sets vertical tab at present position* 

ESC (Nl ; N2; . . . NMv (IB, 5B, Nl , 3B, N2, 3B, . . , NM, 76) Sets vertical tabs at lines Nl , N2 . . . NM 
where each N is a decimal number between 1 and 84 (leading zeros are not required). Vertical tabs can be 
set for each line. The maximum number of tabs that can be set with a single command is 16.* 

ESC (4g (1 B, 5B, 34, 67)) Clears all vertical tab settings.* 



B-15 

Digital Systems Division 




946259-9701 



Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

ESC (Ig (IB, 5B, 31 , 67)) Clears vertical tab at present position.* 

ESCH (IB, 48) Sets horizontal tab at present position.* 

ESC (N1;N2; . . . NMu (IB, 5B, Nl, B8, N2, 3B, . . . NM, 75)) Sets horizontal tabs at columns Nl, N2, . . . 
NM where each N is a decimal number between 1 and 132 (leading zeros not required). Horizontal tabs 
may be set for each column. The maximum number of tabs that can be set with a single command is 16.* 

ESC (2g (IB, 5B, 32, 67)) Clears all horizontal tab settings.* 

ESC (Og (IB, 5B, 30, 67)) Clears horizontal tab setting at present position.* 

ESC (Nt (IB, 5B, 4E, 74)) Sets form length to N, where N is a decimal number between 1 and 84 (leading 
zeros not required). Sets top of form at present position. Sets top margin to 1 and bottom margin to N. 

ESC (Nr (IB, 5B, 4E, 72)) Sets top margin to N where N is a decimal number between 1 and 84 (leading 
zeros not required). 

ESC (;Mr (IB, 5B, 3B, M, 72)) Sets bottom margin to M where M is a decunal number between 1 and 84 
(leading zeros not required). 

ESC (N-JVIr (IB, 5B, N, 3B, M, 72)) Sets top of margin to N and sets bottom margin to M. 

Note that 1 < N < M < Form Length for top and bottom margin settings. 

ESC (Ns (IB, 5B, N, 73)) Sets left margin at column N where N is a decimal number between 1 and 132 
(leading zeros not required). 

ESC (-JVls (IB, 5B, 3B, M, 73)) Sets right margin at column M where M is a decimal number between 1 and 
132. 

ESC (N;Ms (IB, 5B, N, 3B, N, 73)) Sets left margin at N and sets right margin at M. 

Note that 1 < N < M < 132 for left and right margins. 

Tab settings outside the margins will be accepted, but tab commands to these settings are not executed. A command 
to tab beyond the right margin will cause an automatic carriage return/line feed. A command to tab to a column left 
of the present print position or left margin is disregarded. Command error status is not set. 

ESCPA\ (IB, 50, 41, 5C) Select single line spacing. 
ESCPB \ (IB, 50, 42, 5C) Select double line spacing. 
ESCPC \ (IB, 50, 43, 5C) Select standard print. 
ESCPD\ (IB, 50, 44, 5C) Select compressed print. 

These standard compressed print selection commands are subject to the same conditions as described for 
the corresponding keyboard-entry only commands. 



^ 
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Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

ESC (IB, 60) Disable manual input (keyboard lock). 

ESCb (IB, 62) Enable manual input (keyboard unlock). 

If the keyboard is locked, it will be unlocked when the terminal is switched to LCL or Standby; the RESET key is 
actuated or power is cycled off and on. 

In the four commands following, N is a decimal number (leading zeros not required). 

ESC(N (IB, 5B, N)) Absolute tabulation to column N. Column N must be to the right of the present print 
position. 

ESC (Na (IB, 5B, N, 61)) Relative tabulation N columns to the right of the present print position. 

ESC (Nd (IB, 5B, N, 64)) Absolute paper advance to line N, relative to top of form. line N must be below 
the present print line. 

ESC (Ne (IB, 5B, N, 65)) Relative paper advance, N lines down from the present position. 

Note that for both absolute and relative tabulation, the final position must be between the left margin and the right 
margin. Also, for both absolute and relative paper motion, the final line number must be between the top margin 
and the bottom margin. Commands which violate these rules cause "invalid Escape sequence received" status to 
/^^ be set. Such commands are not executed. 

ESCPE \ (IB, 50, 45, 5C) Printer OFF. 

ESCPF\ (IB, 50, 46, 5C) Printer ON. 

The printer, if off, is turned on when the terminal is switched to LCL or Standby; the RESET key is 
actuated or power is cycled off and then on. 



ESC (c (IB, 5B, 63)) Request Configuration Report. 

The terminal responds by transmitting ESC (820; CI ; C2; . . . Cnc where each C is a two-digit number 
corresponding to the enabled configuration parameters. The terminal does not print the "820;" portion 
of the report, the local copy of the report being ESC CI ; C2; . . . Cnc. If a half-duplex line turnaround 
character is programmed, the configuration report is terminated with that character. 

ESC (n (IB, 5B, 6E)) Request Terminal Status Report. 

The terminal responds by transmitting ESC (820; El ; El ; . . . ENn where each E is a two-digit number 
corresponding to the active status codes. The terminal does not print the "820;" portion of the sequence 
locally. In half-duplex mode the status report is terminated with a programmed line turnaround charac- 
ter. 
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Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

For read/write ASCII operation, the DSR filters all control characters in the range - IFig , except for the follow- 
ing: 

BEL 07 Bell 

BS 08 Backspace (also causes a line feed on a read operation) 

HT 09 Horizontal tab (converted to a space when echoed on a read operation) 

LP OA Line feed 

FF OC Form feed (eight line feed operations) 

CR OD Carriage return (terminates input record on a read) 



NOTE 

Certain forms control commands, identified by an asterisk (*) in the preceding 
description, are ignored if the NVFC option is not installed. 
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Table B-6. ASR 33 Teletypewriter Character Set 







Printer 




Keyboard 


Punch (ASCII) 


Punch (Du-ect) 


END-OF-RECORD 


Depletion of 


CR 


Depletion of 


Depletion of 






character count 




character count 


character count 


END-OF-FILE 




N/A 




DC3 


DC3 


N/A 






Reader (ASCII) 


Reader (Direct) 






END-OF-RECORD 


CR 




DC3 






END-OF-FILE 




DC3 




N/A 






Character Hexadecimal Character 


Hexadecunal 


Character 


Hexadecimal 


Space 


20 




A 


41 


C 


63 


! 


21 




B 


42 


D 


64 


»» 


22 




C 


43 


E 


65 


# 


23 




D 


44 


F 


66 


$ 


24 




E 


45 


G 


67 


% 


25 




F 


46 


H 


68 


& 


26 




G 


47 


I 


69 


» 


27 




H 


48 


J 


6A 


( 


28 




I 


49 


K 


6B 


) 


29 




J 


4A 


L 


6C 


* 


2A 




K 


4B 


M 


6D 


+ 


2B 




L 


4C 


N 


6E 


J 


2C 




M 


4D 





6F 


— 


2D 




N 


4E 


P 


70 


, 


2E 







4F 


Q 


71 


/ 


2F 




P 


50 


R 


72 





30 




Q 


51 


S 


73 


1 


31 




R 


52 


T 


74 


2 


32 




S 


53 


U 


75 


3 


33 




T 


54 


V 


76 


4 


34 




U 


55 


w 


77 


5 


35 




V 


56 


X 


78 


6 


36 




w 


57 


Y 


79 


7 


37 




X 


58 


Z 


7A 


8 


38 




Y 


59 


[ 


7B 


9 


39 




z 


5A 


/ 


7C 




3A 




[ 


5B 


] 


7D 


> 


3B 




/ 


5C 


t 


7E 


< 


3C 




] 


5D 






= 


3D 




t 


5E 






> 


3E 




<- 


5F 






? 


3F 




@ 


60 






@ 


40 




A 
B 


61 
62 







/lf^^^\^ 



B-19 



Digital Systems Division 




946259-9701 



Table B-6. ASR 33 Teletypewriter Character Set (Continued) 

Notes 



Printer: 



1 . BS character (OSie) results in a backspace operation. 

2. HI character (09 le) results in printing a space. 

3. LF character (OAis) results in a line feed operation. 

4. CR character (ODig) results in a carriage return operation. 

5. FF character (OC15) results in eight line feed operation. 

6. End-of-record occurs when specified number of characters have been printed. 

7. Maximum buffer size is 72 characters. 

Keyboard: 

1 . BS character (08 ig) is returned to printer as LF and BS. Deletes most recently entered character in buffer. 

2. HT character (09 le) is returned to printer as space. Character is placed in buffer. ^^ 

3. LF character (ODig) is returned to printer as CR, and character is not placed in buffer; terminates the record. 

4. DEL character (7Fi6) is returned to printer as a line feed and carriage return. Character deletes current input 
record. 

5. Maximum buffer size is 72 characters. 

Paper Tape Punch: 



1 . The end of block character sequence for ASCII is CR (ODig), LF (OAig), DC3 (Hie), NULL (OOie), Null (OOig), 
Null (OOie), Null (OOie) for Direct is DC3 (Uig), Null (OOje), Null (OOie), Null (OOig), NuU (OOie). The end-of- 
file character sequence for ASCII is DC3 (Hie), CR (ODie), LF (OAig), DC3 (13i6), Null (OOie), NuU (OOie), 
NuU (OOig), NuU (OOie) for Direct is not applicable. 

2. The characters BEL (07 le), BS (08 15), HT (09 ig), and FF (OCie) are punched on tape unchanged. 

3. The character CR (ODie) is translated to ETB (11 le) and punched. 

4. The character DC3 (13 15) may be placed within a record, but may not be the first character of the record other 
than the end-of-fUe record. 

5. End-of-record occurs when SCB specified number of characters have been punched. 

6. Direct mode punches aU characters. If a punch-off is in the buffer, a punch-on is output immediately foUowing 
the character. 

Paper Tape Reader: 

1 . All nuU characters are ignored at the first of the record and the first nonnuU character is the first valid character. 

2. The character BEL (07 le), BS (08 15), HT (09 le) and FF (OCie) are stored in the user's buffer. 

3. The character ETB (17i6) is stored in the user's buffer as a CR (ODie). 

4. The character CR (ODig) indicates end-of-record, and is not stored in the buffer. 

5. The character DC3 (13 15) as the first character of a record indicates an end-of-fUe record. The system returns 
end-of-fUe status after positioning the tape at the beginning of the next record. The DC3 is not stored in the 
buffer. 

6. In direct mode aU characters are stored in the buffer until the buffer is fuU, then the program searches for a DC3 
character to terminate. 
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APPENDIX C 
USER-SUPPLIED MODULES 

C.l INTRODUCTION 

Texas Instruments supplies support modules for a large number of user options in a TX990 
operating system. However, there are some user needs that require modules that are not available, 
which the user must provide. These modules are: 

• DSR (including an interrupt routine) for a unique peripheral device 

• Extended Operation routines for user's extended operations 

• Supervisor call routines for user supervisor calls 

The user-supplied modules execute in the privileged mode in the Model 990/10 Computer, and 
all instructions are available. In the Model 990/4 Computer and the Model 990/5 Computer all 
instructions are also available. For information on writing each type of routine consult the TX990 
System Documentation manual, part number 944776-9701. 



NOTE 

When writing modules to be linked with the operating system (i.e., 
DSRs, XOPs, SVCs, user tasks), do NOT use the AORG (absolute 
origin) assembler directive. The TXBOOT program cannot load a 
system with any absolute origins in it. 
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APPENDIX D 
GLOSSARY 



Allocation Unit - A unit of space allocation on the diskette used during file management. An 
allocation unit is equal to six sectors. There are 333 allocation units on a diskette. 

Boot Program - A program that loads the Operating System into memory and starts the Operating 
System executing. 

COMMON - An area of memory which may be coded by use of the system console keyboard (e.g., 

a 733 ASR, a 91 1 VDT, et al) or by means of a task-specified-code and then made accessible 

for use by a task through the Get COMMON Data address supervisor call. The size of the 

system COMMON memory area is determined by a system parameter specified when the 

^gm>\^ system is generated. 

Default-substitute - A substitute pathname, or field of a pathname, provided by some utility 
programs when the program or keyboard-entry does not supply the data. 

Device Name Table - A table accessed by the File Management supervisor call to obtain the address 
of the Physical Device Table (PDT) corresponding to a device name. Contains all device names 
defined in the system and addresses of the PDTs for the devices. 

Device Service Routine - A routine of the TX990 Operating System that controls I/O operations 
f^ with a device. 

DNT - Device Name Table. 

DSR - Device Service Routine. 

Dynamic Task Area - The area of memory into which tasks may be loaded and executed. Tasks can 
only be loaded by using the Operator Communication Package (OCP) or the TXDS control 
program. 

ECN - Engineering Change Notice. 

End-of-file - A record in a file (either logically or physically) that marks the end of the file. The 
character sequences that denote end-of-file for the file-oriented supported devices are shown in 
Appendix B. 

End-of-record - A character of a record that marks the end of the record. The characters that 
denote end-of-record for supported devices are shown in Appendix B. 

EOF - End-of-file. 

EOR — End-of-record. 

GENTX - The system generation task, which obtains system parameters interactively from the 
keyboard of the system console. GENTX builds source statement files from which modules 
TXDATA and TASKDF are assembled. 

IDT - Program identifier of the source module. 
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Initial Program Load - The loading of a TX990 system from disc, cassette, or cards, placing the 
module in memory and starting execution of the system. 

Interrupt Handler - The portion of a DSR which processes the interrupt. 

I/O Supervisor - The portion of TX990 that processes File Management supervisor calls, and passes 
control to the Device Service Routine (DSR) for the device. 

IPL - Initial Program Load. 

Keyboard Status Block (KSB) - A data structure in TXDATA used for character mode I/O with a 
VDT. TXDATA includes a KSB for each VDT. 

KSB - Keyboard Status Block. 

LDT - Logical Device Table. 

Logical Device Table (LDT) - A table in TXDATA that contains a Logical Unit Number (LUNO) 
and the address of the Physical Device Table (PDT) that corresponds to the device assigned to 
the LUNO. 

Logical Unit Number (LUNO) - A number by which an I/O operation specifies the device for the 
operation. 

LUNO - Logical Unit Number. 

OCP - Operator Communication Package , 

Operator Communication Package (OCP) - A package of modules that contains the routines 
for the commands by which the operator or user communicates with TX990. 

PC — Program Counter. 

PDT - Physical Device Table. 

Physical Device Table (PDT) - A table in TXDATA that contains device-related data required by .^ 
the Device Service Routine (DSR) in an I/O supervisor call for the device. 

Program Counter (PC) - A register in the computer hardware that contains the address of the next 
instruction to be executed. 

Real-Time Task - Usually a task which must monitor external events and respond within a certain 
time. A process control task which gets bid by an interrupt handler (DSR) and then controls 
the process using CRU commands is an example of a real-time task. 

Stand-alone Program - A program that executes without an operating system. 

Status Register - A register in the computer hardware that contains condition bits and the inter- 
rupt mask. 
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Supervisor Call Block — A block of memory that defines a supervisor call, addressed by the XOP 
instruction. The code of the supervisor call is in byte of the supervisor call block. The num- 
ber of additional bytes (if any) and the content of the additional bytes are defined for each 
supervisor call. 



SCB - Supervisor Call Block. 

Supervisor Call Table — A table in TXROOT in which entry points to supervisor call routines are 
Usted in a supervisor call code order. 

SVC - Supervisor Call 

System Time Unit - An interval of 50 milliseconds used in task scheduling and time delays. 

Task Data Division — One of two logical divisions within a task. The data division contains one or 
more workspaces, data structures, supervisor call blocks, and data for the task. A data division 
may or may not be assembled separately from the procedure division of the task, and is not 
shared with any other task. 

Task Management — Task Management maintains a state code for each task. The state codes are 
Hsted in Appendix G. 

Task Scheduler — Initiates execution of a user task (see paragraph 11.2). When the currently 
executing task completes a time slice, the task scheduler passes control to the oldest task on 
the active list for the highest priority (0). If there is no task on the active Ust for priority 0, 
^^ the oldest task on the active list for the next highest priority receives control. 

Task Status Block (TSB) - A data structure in TXDATA used by the TX990 Operating System to 
control execution of the task. 

Task Time Delay - The result of a task executing a Time Delay supervisor call. The Time Delay 
supervisor call suspends the calling task for a specified number of 50 ms periods. 

Task Time SUce — A period of execution of a task having a maximum length defined when the 
system is generated. A task time sUce begins when the task scheduler passes control to the task. 
jsm\ A task time slice ends: (1) when the system suspends the task upon expiration of the 

maximum time period allowed for a task time sUce; (2) when the task executes a supervisor 
call that suspends the task; (3) when the system suspends the task to await completion of an 
I/O operation. To avoid completely locking out low priority tasks, there is a maximum number 
of consecutive time sUces (weighting factor) for each priority level. When the number of time 
sUces has been used by a priority level, the oldest task on the active list for the next lower 
priority is allowed a time slice before the higher level again has control. The maximum number 
of time sUces for each priority level are system parameters defined when the system is 
generated. The maximum period of a time sUce may be extended by execution of a Do Not 
Suspend supervisor call. The time sUce is less than the maximum time period when the task 
suspends itself, or is suspended awaiting completion of an I/O operation. 

Task Weighting Factor - A count of task time sUces for a priority level. When the number of task 
time sUces specified as the weighting factor for priority level has been used by tasks at that 
priority level after a task at a lower level has had control, a task at a lower priority level 
receives control for a time slice. 
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Task Area, Dynamic - Memory area where tasks may be loaded and executed (see Dynamic Task 
Area and Task, Uses, Loading oQ. 

Task, Active - A task which is in memory on an active queue, waiting for a time sUce. 

Task, Bid - To start execution of a task causing the TX990 Operating System to enter the task on 
the active list according to its priority level. 

Task, Debugging of a — The process of removing errors from a task. 

Task, Diagnostic (DTASK) - A system task that terminates a task when fatal errors occur in the 
task, and prints an error message. 

Task, Executing a - Controlling the processor and the resources of the computer. 

Task, Linked - Consists of separately assembled modules that have been combined by resolving 
external references and definitions in the modules to form a single executable module. 

Task, Loaded - A task copied from an external storage medium into the memory of the computer 
in preparation for execution. 

Tasks, Multiple - Two or more tasks concurrently active in an operating system. 

Task, Procedure Division - One of two logical divisions within a task. The procedure division 
contains the executable code for the task. A procedure division may or may not be assembled 
separately from the data division of the task and may be shared with other tasks. 

Task, Real-Time - See Real-Time Task. 

Task, Suspended - A task temporarily removed from the active list and from execution as a result 
of a supervisor call or during an 1/0 operation. 

Task, Terminated - A task removed from execution and from the active list either at normal 
completion or at an abnormal termination initiated by the operator or by the diagnostic task 
when a fatal error is detected. 

Task, Time Delay - A task which has halted execution for a specified length of time, at the end of 
which the task is reactivated. 

Task, User, Loading of - The task loaded into the dynamic task area using the OCP LPROG 
command. 

Task, Waiting - A task waiting for completion of an I/O operation or for a system function or 
resource. 

Volume Name - A one to four character name, other than a drive name, by which a diskette may 
be accessed. 
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/«^ Workspace — A 16-word area of memory addressed as workspace registers through 15. The active 

^ workspace is defined by the contents of the workspace pointer register. 

Workspace Pointer (WP) - A register that contains the address of workspace register 0. 

Workspace Register - A memory word accessible to an instruction of the computer as a general 
purpose register. It may be used as an accumulator, a data register, an index register, or an 
address register. 

WP — Workspace pointer register. 
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E.l INTRODUCTION 

The upward compatibility of the TX990 operating system to the RX990 and DXIO operating 
systems allows tasks that execute under TX990 to be executed under RX990 and DXIO when the 
proper considerations are met. This appendix describes those considerations. This appendix also 
compares the supervisor calls of the three systems. The compatibiUty information cannot be 
totally specified because of the existence of several releases of each system. For information about 
compatibility with a specific release of TX990 or DXIO, the user must study the information about 
RX990 or DXIO and note the difference. 

E.2 TASK STRUCTURE COMPATIBILITY 

The task structure required for the TX990 operation system is compatible with that of RX990 and 
DXIO. Tasks that execute in the dynamic task area of TX990 and other tasks that consist of a data 
division and procedure division in the same module may be installed under RX990 and DXIO as 
either memory-resident or disc-resident tasks under DXIO without modification. Tasks that share a 
procedure division use the mapping capabiUties of the Model 990/10 Computer when executed 
under the RX990 or DXIO operating systems. The addresses of the procedure division are mapped 
into the low order addresses of the addressable memory, and the addresses of the data division are 
mapped into the addresses above those of the procedure, beginning on a 32-byte boundary. Only 
the address in the index register used to address data is affected by this difference. The task may be 
relinked to provide this address, or the address can be patched. 

E.3 SUPERVISOR CALLS 

The supervisor calls which are available to the TX990 operating system user but which are not 
supported in the same manner by TX990 or DXIO are: 



SVC 

Number 
(Hex) 


Description 


RX 

Support 


DX 

Support 


Notes 


8, 18, lA 


VDT Utility Functions 
and VDT Character I/O 


Yes 


No 


1 


15 


FUe Management (TX990 
Release 1 .0 only) 


No 


No 


2 


12,13 


Get Memory, Release Memory 


Yes 


Yes 


3 


10, IB 


Get Common Data Address and 
Return Common 


Yes 


Yes 


3 


16 


End of Program 


Yes 


Yes 


4 


20 


Get Own ID 


Yes 


No 


5 


21 


Get System Table 


No 


No 


6 


23 


Make Task Privileged 


Yes 


Yes 


7 
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Notes: 



DXIO will allow the SVC >23 but wUl only check to see that the calling task was installed privileged. 



E.4 FILE MANAGEMENT 

The TX990 Operating System supports two file types, sequential and relative record. Sequential 
files are automatically blocked and blank compressed in the TX990 Operating System, while in the 
DXIO Operating System the user optionally controls blocking and blank compression. Only one 
user may access a sequential file at a time. The user's position in the file is maintained across close 
and assign operations, while in the DXIO Operating System, multiple reads and a single write opera- 
tion may be operating simultaneously and assign operations may cause a rewind operation to occur. 
The file pathname, under a TX990 Operating System assign operation, is compatible with the DXIO 
Operating System if the following structure is maintained: device file name (where device is a maxi- 
mum of 4 characters and file name is a maximum of 6 characters, e.g., DSCFILMN). The "exclusive 
all" access privilege code on an open service call in the TX990 Operation System is 00 while in the 
DXIO Operating System it is an 01 . TX990 does not support file management. 






1. DXIO gives the user a more powerful VDT utility capability via the extended SCB (see Volume III, 
Section VI of the Model 990 Computer DXIO Operating System (Release 3) Reference Manual, 
946250-9703). Limited VDT I/O may be performed in a compatible manner using SVC (I/O) and 
the READ DIRECT (OA) and WRITE DIRECT (OC) opcodes. 

2. The ninety -series file management opcodes for SVC (I/O) should be used in place of SVC 15 to achieve 
compatibility. 

3. The TX990 Operating System task that shares a procedure and contains both a Get Memory and Get 
Common Data Address supervisor call has an additional restriction under RX990 or DXIO. Memory 
management in RX990 and DXIO utilizes the mapping capabilities of the computer. The addressable 
memory area of a task consists of three contiguous address segments. The procedure division is mapped 
into the lowest of these address segments, beginning at address zero. The data division is mapped into 
the next higher segment, leaving one segment for either common memory or a memory block obtained 
with a Get Memory call. A Get Memory caU must be followed by a Release Memory call before a Get 
Common Data Address call can be executed. Similarly, a Get Common Data Address call must be ^ 
followed by a Return Common call before a Get Memory call can be executed. The address returned 

by a Get Memory supervisor call or a Get Common Data address is aligned on a 32-byte boundary 
inRX990andDX10. 

4. The End of Program supervisor call performs different operations in the TX990 operating system; after 
terminating the task, it activates the rebid task, which is normally the TX990 Control Program. 

5. DXIO does not use SVC ->20 for the same function. SVC >2E should be used if program transporta- 
bility to DXIO is required. ^"^ 

6. Addressing the system table is not supported on RX990. DXIO has an SVC (K 

6. Addressing the system table is not supported on RX990. DXIO has an SVC (>32) for privileged tasks 
to be able to obtain the address of the system table. System tables for TX990, RX990, and DXIO 
are not structured in the same manner. Therefore, any data being referenced via these SVC's would 
be incompatible. 



^ 
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E.5 ERROR CODES 

(^ Not all of the error codes are the same between TX990 and DXIO, particularly those returned by 

file management and file utility routines. Tasks which are programmed to respond to specific error 
codes may not run on both systems without modifications. 
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APPENDIX G 
TASK STATE CODES 

The user-task supervisor calls which return one of the task state codes listed in table G-1 to byte 1 
of the supervisor call block are: 

• Bid Task Supervisor Call 

Activate Suspended Task Supervisor Call 

Activate Time Delay Task Supervisor Call 






The user may code his program to read out the task state code to an output device or, using the 
OCP STate (ST) command, the user can cause a terminal to print out the task state codes.' 

Table G-1 . List of Task State Codes 

Code 
(Hexadecimal) Significance 

00 Active task 

04 Terminated task 

f^ 05 Task in time delay 

06 Suspended task 



/#*^ 



08 Task awaiting VDT character input 

09 Task awaiting completion of I/O 
OA Task queued for I/O 

OB Task queued for file utility routine 

OC Task on the diagnostic queue 

OD Task waiting for file management completion 

10 Task queued for file management. 
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APPENDIX H 
PRINTOUT OF FATAL TASK ERROR CODES OR DISPLAY OF ILLEGAL INTERRUPT CODE 

The capability of printing out fatal task error codes or displaying an illegal interrupt code is 
available to the user when the Diagnostic Task (DTASK) module is supplied with the TX990 
Operating System. DTASK begins to execute when the TX990 Operating System error logic detects 
a fatal error during task execution; the result of the DTASK module being executed is the printout 
of the fatal task error code or the display of the illegal interrupt code. The fatal task error code is 
printed out on a LUNO, as described below in this appendix, when the task being executed does not 
specify an end action to be executed; the illegal interrupt is displayed on the Programmer Panel. 
When DTASK prints the error message identifying the error, it causes the task to be terminated. The 
fatal errors detected by TX990 are listed in table H-1 . 

^0^, When TX990 detects that execution of a task has resulted in a fatal error and the task does not 

perform end action, the error logic removes the task in error from the active queue, places it on the 
diagnostic queue, sets the task's state to on diagnostic queue, and executes DTASK. DTASK prints 
an error message on LUNO as shown in the following example: 

*TASK=0F,ERROR=03 ,ADDRESS-2 1 4E 
WP=2 1 54,PC-28A0,ST=300F 

The example shows that the task having identifier Fj^ attempted to access memory address beyond 
^^^ the existing range of memory (error code 3). The task address is 214Ei6 ; the current workspace is 

at address 2154i6; and the program counter contains 28A0i6. Since the program counter is ad- 
vanced to the next address before an instruction is executed, the instruction that attempted the 
memory access would be at address 289Ai6, 289Ci6, or 289Ei6, according to the size of the 
instruction. The status register contains 300Fi6 . 

After printing the error message, DTASK sets a flag in the Task Status Block (TSB) and places the 
task on the active queue. The flag set by DTASK causes the scheduler to terminate the task. 



f^^^^ 



In the event that DTASK itself commits a fatal error, it prints the following message on LUNO 0: 

HELP! 
This represents a system error that requires the system to be loaded again. 
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Illegal interrupt. An external interrupt, for which there is no inter- 
rupt routine, has occurred. The user may display the status register 
to determine the interrupt level and must clear the interrupt before 
attempting to resume operation. 



*TILINE is a registered trademark of Texas Instruments Incorporated. 



^ 



Table H-1 . Fatal Task Error Codes and Illegal Interrupt Code 
Error Code Error Description 

1 Memory parity error. Can only occur if the computer is equipped 
with memory parity or error correction hardware. 

2 Illegal operation code. Can only occur in a Model 990/10 Computer. 

3 TILINE* timeout. Nonexistent memory was addressed in a Model 
990/10 Computer, or a nonexistent TILINE peripheral was address- 
ed in a Model 990/5 or Model 990/10 Computer. 

4 Illegal XOP. An XOP instruction having an undefined extended 
operation number or an illegal supervisor call was executed. 

5 Map error. An access outside of the address space defined by the 

current map was attempted. Can occur only in a Model 990/10 ^^ 

Computer with map option in which the map is enabled. Since 
TX990 does not enable the map, this error could only occur if the 
user task enabled the map. 

6 Privileged operation. A privileged instruction was attempted in the 
nonprivileged mode. Can only occur in a Model 990/10 Computer 
in the nonprivileged mode. 
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APPENDIX I 
I/O ERROR CODES 



Code 
(Hexadecimal) Description 

DSR ERRORS 

00 NO ERROR 

01 ILLEGAL LUNO 

02 ILLEGAL OPERATION CODE 

03 LUNO IS NOT YET OPENED 

04 RECORD LOST DUE TO POWER FAILURE 
f*" 05 ILLEGAL MEMORY ADDRESS 

06 TIME OUT, OR ABORT 

07 READ CHECK ERROR 

11 DEVICE ERROR 

1 2 NO ADDRESS MARK FOUND 
1 5 DATA CHECK ERROR 

1 9 DISKETTE NOT READY 
lA WRITE PROTECT 

1 B EQUIPMENT CHECK ERROR 

^^ 1 C INVALID TRACK OR SECTOR 

1 D SEEK ERROR OR ID NOT FOUND 

1 E DELETED SECTOR DETECTED 

FILE MANAGEMENT ERRORS 

20 LUNO IS IN USE 

21 BAD DISC NAME 

22 PATHNAME HAS A SYNTAX ERROR 

23 ILLEGAL FUR OPCODE 
r^ 24 BAD PARAMETER IN PRB 

25 DISKETTE IS FULL 

26 DUPLICATE FILE NAME 

27 FILE NAME IS UNDEFINED 

28 ILLEGAL LUNO 

29 SYSTEM BUFFER AREA FULL 
2A SYSTEM CAN'T GET MEMORY 
2B FILE MANAGEMENT ERROR 
2C CAN'T RELEASE SYSTEM LUNO 
2D FILE IS PROTECTED 

2E ABNORMAL FUR TERMINATION 

2F FILE UTILITY DOESN'T EXIST IN SYSTEM 

30 NON-EXISTENT RECORD 

3 1 EVENT KEY SVC TASK NOT IN SYSTEM 
3B INVALID ACCESS PRIVILEGE 

am^ 3E FILE CONTROL BLOCK ERROR 

3F FILE DIRECTORY FULL 
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I/O ERROR CODES (Continued) 

Code 
(Hexadecimal) Description 

TASK LOADER ERROR 

60 I/O ERROR, LOAD NOT COMPLETE 

6 1 OBJECT MODULE CONTAINS NONRELOC ATABLE OBJECT CODE 

62 CHECKSUM ERROR LOAD ABORTED 

63 LOADER RAN OUT OF MEMORY 

64 TASK 10 IS BUSY 

65 IMAGE FILE ERROR 

VDT ERRORS 

01 Illegal station number. ,/^ 

04 Illegal cursor position specified. 

06 No unprotected field found in tab function. 

07 No unprotected field found in read function of 
unspecified length 

80 VDT currently in record mode or assigned to 

another task. 
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APPENDIX J 
SYSTEM TASKS 

J.l INTRODUCTION 

There are eleven system tasks in a complete TX990 Operating System: (1) one Operator Communi- 
cation Package (OCP); (2) one Initial Start Task (STASK); (3) one Diagnostic Task (DTASK); 
(4) four File Management Tasks (TXFMPl, TXFMP2, TXFMP3, TXFMP4); (5) one File Utility 
Routine (FUR); (6) one rebid task; (7) one Volume Task; and (8) one temporary task used during 
procedure installation and deletion in a Multiple Dynamic Task system. The operation of OCP 
and the supported OCP commands are described in Section V. Descriptions of the other system 
tasks and their operations are included in this appendix. 

J.2 INITIAL START TASK (STASK) 

f^^> The initial start task (STASK) begins execution at the completion of each IPL to identify the 

revision level of the operating system and to indicate that the IPL has executed successfully. The 
following is an example of the message printed by STASK: 

TX990 V.R.E YY.DDD 

MEMORY SIZE WORDS: 12288 AVAILABLE: 5940 

The memory size printed is the decimal number of words of memory in the system. The size, in 
words, of the dynamic task area, is printed as the available memory. 

When STASK is linked following TXEND, it is located in the dynamic task area, where it will be 
overlaid by the first user task installed in the dynamic task area. It is assigned task identifier 
10i6. When it is desired to execute STASK following a manual restart, STASK must be linked 
ahead of TXEND. 

J.3 DIAGNOSTIC TASK (DTASK - TASK ID D^e )• 

The diagnostic task (DTASK) is executed when TX990 error logic detects a fatal error in a task. 
DTASK prints an error message identifying the error and causes the task to be terminated in error. 
The fatal errors detected by TX990 are listed in Appendix F. 

When TX990 detects that execution of a task has resulted in a fatal error and the task does not 
perform end action, the error logic removes the task in error from the active queue, places it on the 
diagnostic queue, sets the task's state to on diagnostic queue, and executes DTASK. DTASK prints 
an error message on LUNO as shown in the following example: 

*TASK=OF, ERROR=03, ADDRESS=214E 
WP=2154, PC=28A0, ST=300F 

The example shows that the task having identifier Fjg attempted to access a memory address 
beyond the existing range of memory (error code 3). The task address is 214Ei6, the current 
workspace is at address 2154i6, and the program counter contains 28A0i6. Since the program 
counter is advanced to the next address before an instruction is executed, the instruction that 
attempted the memory access would be at address 289Ai6, 289Ci6, or 289Fi6, according to the 
size of the instruction. The status register contains 300Fi6 • 
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J.8 INSTALL (DELETE PROCEDURE (TASK ID A^e ) 

In a TX990 system with Multiple Dynamic Tasks, a temporary task is created and used while install- 
ing and deleting procedures. It is deleted after the operation is complete. Task ID Axe niust not be 
assigned to a user task when Multiple Dynamic Tasks are defined in a TX990 system. 
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After printing the error message, DTASK sets a flag in the Task Status Block (TSB) and places the 
task on the active queue. The flag set by DTASK causes the scheduler to terminate the task. 

In the event that DTASK itself commits a fatal error, it prints the following message on LUNO 0: 

HELP! 

This represents a system error that requires the system to be loaded again. 

J.4 FILE MANAGEMENT TASKS (TXFMPl, TXFMP2, TXFMP3, TXFMP4 - TASK ID, 

F0i6,Fli6,F2i5,F3i5) 

File management must be included in the TX990/TXDS system to enable the user task to com- 
municate with files on the diskette. File management consists of one procedure and a data section 
for each diskette drive included in the system. The four data sections (TXFMPl, TXFMP2, 
TXFMP3, TXFMP4) when linked with the procedure (TXFMP) define the File Management task 
and must be included in the task definition at system generation time. (See Section 7 entitled 
"System Generation".) If one diskette drive is in the system, TXFMPl has to be included: if two 
diskette drives are included in the system, both TXFMPl and one TXFMP2 must be included: '^ 

etc. The required GENTX parameters for these file management tasks are described in the System 
Task Definition Table. 

J.5 FILE UTILITY TASK (FUR - TASK ID B^e ) 

The File Utility Routine (FUR) assigns and releases LUNOs to files and performs file maintenance 
functions. 

If the file management task is included in the system, the File Utility task must also be included 

during system generation. The required GENTX parameters for FUR are described in table 7-1 ^^ 

entitled "System Task Definition". 

J.6 REBIDTASK 

The system rebid task is the task that will be activated whenever an end program supervisor call 
is made. For standard TX990/TXDS systems, the TXDS control program is defined as the rebid 
task, and will be activated when a task terminates with an end program supervisor call, task 
ID 16i6. The user may wish to designate another task as the rebid task. This may be accomplished 
in the following manner: 

1 . Place the following statements in the new Rebid Task. ^ 

DEF REBID 

REBID EQU ID*>100 

where ID = Task ID of the new Rebid task. 

2. If the TXDS control program is included in the system, link this module before module 
CNTROL. 

J.7 VOLUME NAME SUPPORT (VOLUME - TASK ID C^e ) 

The volume name support task associates a volume name with a diskette drive, allowing files on the 
diskette to be assessed through the volume name as well as the device name. 
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APPENDIX K 
TX990 SYSTEM GENERATION USING DXIO RELEASE 3.2 

GENTX must be installed and executed using the IT and XTS commands on a DXIO system. 
Perform the following steps on a DXIO release 3.2 system: 

1 . Place the GENTX object module on a DXl sequential file or device. If the module is on 
cassette, place it in a cassette drive. If it is on diskette, execute the DXIO conversion 
utility TXDX and convert the object file to a DXIO sequential file, 

2. Install the task, using the IT command: 

IT PF = .SSPROGA, TN = GENTX, OBJ = <acnm>, TI = <id> 

where <acnm> is the DXIO access name for the file or cassette unit which contains the 
GNTXDX object module and <id> is the task's ID 

3. Execute the task, using the XTS command: 

XTS TN = GENTX, PF = .SSPROGA 

r^ ^- Hp°" i?^*^^*^°" °f ^^^ generation procedure, the following message is displayed by the 

GENTX task: ' 

GENTX V.R.E YY.DDD TX990 SYSGEN 

5. After the message is displayed, the GENTX program enters the definition phase described 
in paragraphs 9.3.3 through 9.3.4. Refer to this section for a description of the user 
options. 



6. Upon completion of the construction phase the source programs generated for TXDATA 
and TASKDF must be assembled. These source programs may be assembled using 
SDSMAC. The object code files created will be used as input to the linking process in 
step 10. 

^' cit>fm\^/°^"*' *^® TX990 object modules must be selected from the DSRLIB OCPLIB 
nprnrp m'l'^^V,^ cassettes This selection process is accompUshed by use of the 
OBJMGR (Object Manager Task). A file is created as output from OBJMGR and will be 
used as mput to the Hnking process in step 8. 

8. The Link Editor is used to link the object modules of TXDATA, TASKDF and TX990 
parts created in the above steps. This may be accomplished using the following Unk 
control tile: 

NOSYMT 

PHASE 0,TX990 

INCLUDE name 1 

INCLUDE name 2 

INCLUDE name 3 

END 
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where 

name 1 is the pathname for TXDATA object file 

name 2 is the pathname for TASKDF object file 

name 3 is the pathname for the selected TX990 parts file. 

The output of SDSLNK may now be copied to cassette or diskette and used on a TX990 
system. 
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APPENDIX L 
SUPPORT FOR THE 5MT/6MT I/O INTERFACE SPECIAL DEVICE 



L.l SYSTEM GENERATION PARAMETERS 

To include a 5MT/6MT Serial I/O Interface Module in a hardware configuration, a new operating 
system must be generated, as described in the section on system generation. During execution of 
GENTX, the 5MT/6MT module must be defined as a special device. The responses to GENTX 
prompts are shown in table L-1. Items in all capitals must be entered as shown. 



Table L-1 . GENTX Parameters for the 5MT/6MT Modules 



Prompt 

CHASSIS 

DEV NAME 

DEVTYPE 

CRU BASE ADDR 

ACCESS MODE 

INT LEVEL 

or 
INT POSITION 

TIME-OUT COUNT 

CRU INT LINE 

ENTRY LABEL OF DSR 



Response 

Number of the chassis in which the interface 
card is connected (0-7) 

1 to 4 character name (e.g. 1056); first 
character must be alphabetic 

SD 

As shown in the chart on top of the chassis 

FILE 

As shown in the chart on top of the chassis 

As connected to the expansion chassis 

Desired number, as described in section 9 

31 

DSR5MT 



ENTRY LABEL OF ROUTINE INTRUP 



INT BRANCH LABEL 
EXTENSION DATA 



UNSOL 



carriage return 



L.2 INCLUDING THE DEVICE SERVICE ROUTINE 

When linking the newly generated system, the module DSR5MT in file :DSRLIB/OBJ on the 
TX990 parts diskette must be included. See the paragraph entitled LINKING THE NEW SYSTEM 
in section 9, and the section on the Object Manager, OBJMGR, for details on how to include this 
DSR. 
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0-8 


Not used 


9 


Self-test enabled 


10-11 


If 00 — transmit/receive mode 




01 — sequential read/ write mode 




1 1 - random read/write mode 


12 


I/F module busy 


13 


Power on (0 = power off) 


14 


I/F interrupt unmasked 


15 


I/F interrupt present 



^ 



L.3 FUNCTIONAL DESCRIPTION OF THE 5MT/6MT MODULE 

There are different modes of operation provided by the 5MT/6MT DSR: read status, read-random, 
write-random, read-sequential, and write-sequential mode. Any of the read/write modes may be 
executed in conjunction with a transmit/receive operation using the same supervisor call block 
(SCB), which is described in paragraph L.4. 

All operations possible with the 5MT/6MT interface module can be performed using the SCB and its 
data base. No other control commands are necessary. 

These various modes of operation allow the user to output or retrieve information in single bit 
format (up to 16 bits at a time) or single or multiple word format (up to 16 words at a time), and 
are described in the following paragraphs. 

L.3.1 READ STATUS MODE. The read status mode allows the user to perform a self-test type of 
operation on the interface module. 

When a read status call is made the DSR causes the interface to dump the contents of its output 

RAM into its input RAM and then read the input RAM into a 1 6 word program buffer whose '^ 

address is specified in the SCB. 

Each time a read status call is made the DSR will place several status flags in the 17th word of the 
program buffer. The flag bits have the following significance when set: 

Bit Meaning 



,-«ffl^ 



The usefulness of this call is that the user could output a set of known test data to the output RAM 

and then compare it with the information retrieved from the input buffer to see if the two match. If '^ 

the two sets of data do not match then this indicates the possibiHty of a hardware problem. 

L.3. 2 READ-RANDOM MODE. The read-random mode retrieves information from the input RAM 
one bit at a time or up to as many as 1 6 bits at a time, and is performed after any transmit/receive 
cycle. 

The SCB provides an address in the caUing program for: storage of the input information; the 
starting address of the input RAM where the information will be taken from; and a bit count 
indicating the number of bits to be input. 

With this operation, the status of a single bit can be tested. 

The information input during a read-random operation is always placed by the DSR in a one-word 
program buffer with the starting RAM bit beginning at the right-most bit position of that word. 
Any bit positions to the left not filled with information will be filled with zeroes. 
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L.3.3 WRITE-RANDOM MODE. The write-random mode outputs information from a buffer to 
the output RAM on the 5MT/6MT serial interface, one bit at a time, or up to 16 bits at a time. 

The information to be output is stored in a calling program buffer whose address is given in the SCB 
of the caUing program. The SCB also provides the starting address of a location within the calUng 
program buffer. The DSR starts at this location and outputs the number of bits specified in the bit 
count of the SCB, to the 5MT/6MT output RAM. 

With this operation, a single bit can be output at a time. 

The write-random operation is performed before any transmit/receive operation. 

L.3.4 READ-SEQUENTIAL MODE. The read-sequential mode retrieves information from the 
input RAM in the form of 1 6 bit words. The read-sequential mode can mput as many as 1 6 words 
(256 bits) at a time. 

The SCB provides an address pointing to a buffer in the caUing program where the input 
information will be stored; a RAM base address, pointing to one of the 16 words in RAM where the 
information will be taken from; and a count indicating the number of words to be retrieved. 

The read-sequential operation is performed after the transmit/receive operation. 

L.3.5 WRITE-SEQUENTIAL MODE. The write-sequential mode outputs information from a 
buffer to the output RAM of the 5MT/6MT serial interface, in 16 bit word format, and up to as 
many as 16 words at a time. The information to be output is stored in a calUng program buffer 
whose address is given in the SCB of the caUing program. The SCB also provides the address which 
points to a starting location in the caUing program buffer where the information to be output is 
taken from. The DSR starts at this location and outputs the number of bytes specified in the 
character count of the SCB to the output RAM. 

L.3.6 TRANSMIT/RECEIVE OPERATION. The transmit/receive operation allows the user to 
output aU of the information contained in the output RAM to the 5MT/6MT modules while reading 
the present status of the modules into the input RAM of the serial interface. Both operations are 
performed at the same time. 

The transmit/receive (T/R) operation is initiated by clearing a bit in byte 5 of the SCB. 

When the T/R operation is completed an interrupt is generated. The caUing task is suspended until 
the interrupt is received unless the initiate bit in byte 4 of the SCB is set. When the initiate bit is set, 
control is returned to the caUing task after I/O is initiated. When an interrupt is received the 
information from the 5MT/6MT modules is then present in the input RAM and can be stored in the 
input sotrage buffer. 

The transmit/receive operation precedes the read operations and foUows the write operations when 
the T/R bit is set. 

L.4 SUPERVISOR CALL BLOCK FORMAT 

The SCB consists of a 7 word block as shown in figure L-1. The first six words in the block are 
standard for aU types of I/O with the exception of byte 5 which contains user set bits pecuUar to 
this type of I/O. The remaining word belongs exclusively to this type of I/O. 

Byte contains the supervisor caU code (00) for I/O operation. 
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SVC CODE 


STATUS CODE 


2 


I/O OPCODE 


LUNO 


4 


SYSTEM BITS 




T/R 


6 


7 


6 


GENERAL PURPOSE DATA BUFFER ADDRESS 


8 


RECORD LENGTH 


10 


CHARACTER COUNT 


12 


STARTING RAM ADDR 


BIT COUNT 



^ 



(A) 137507 



Figure L-1. 5MT/6MT I/O Call Block 

Byte 1 is the reserved location where the system places a status code after completion of the 
operation. 

There are 4 status codes that may be returned by the system. 

Normal Completion (00) 

Illegal Operation (02) 

Record Loss Due To Power Failure (04) 

Operation Timed Out Or Terminated Abnormally (06) 

Byte 2 of the SCB contains the user placed I/O opcode indicating which I/O operation will be 
performed. 

The I/O operations are: 

• OPEN (00). The 5MT/6MT serial interface module shall be considered a file oriented 
device, so that an 'OPEN' operation should be performed before proceeding with any 
other operations. The 'OPEN' call returns a status code of 00 in byte 1 of the SCB. 

• CLOSE (01). The 'CLOSE' call ends I/O operation to the device and places a code of 00 
in the status byte of the SCB. 



• READ STATUS (05) 

• READ-SEQUENTIAL (20^6 ) 
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gPN • READ-RANDOM (2 1 le ) 

• WRITE-SEQUENTIAL (22i6 ) 

• WRITE-RANDOM (23 16 ) 

Byte 3 contains the logical unit number (LUNO). 

Byte 4 contains the system flags, described in detail in section 7. 

Byte 5 contains the transmit/receive (T/R) bit in bit location 5. This bit initiates the 
transmit/receive cycle when reset. The cycle being automatically after a write operation and before 
any read operation. 

Bytes 6-7 General Purpose Data Buffer Address. This location can serve as two different types of 
addresses depending on the type of I/O call being made. 

I For a read call the value stored here is the input data buffer address. This address points to the 

location in the calling program where the data to be input from the modules is stored. 

For a write call the value stored here is the output data buffer address. This address points to the 
location in the calling program where the data to be output to the modules is stored. 

Bytes 8-9 Record Length. This location indicates the maximum number of bytes to be transferred 
during a read sequential operation. 

^^ Bytes 10-11 Character Count. The system returns the actual number of bytes transferred during a 

read sequential operation in this location. For a write sequential operation this location contains the 
number of bytes to be output to the module. 

Byte 12 Starting Location Address. The value placed in this location applies to both read and write 
operations. 

For read operations this points to the starting location in the input RAM where the input operation 

15 begun. For bit input, the value in this byte ranges from to 255. For words input, the value 
ranges from to 15. During the read operation the DSR looks at the starting location address value, 

f goes to that corresponding address on the input RAM and inputs the number of words or bits 

specified by the words/bits count into the calling program buffer. The words or bits are placed in 
the program buffer in locations which correspond to the RAM locations. 

Byte 13 Bit Count. This location is used by random-type I/O only. The value placed here must be 
between and 15 and indicates how many bits are to be input or output. A value of indicates that 

1 6 bits are to be input or output. 
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APPENDIX M 
SUPPORT FOR THE 32-IN/TRANSITION DETECTION MODULE SPECIAL DEVICE 



M.l SYSTEM GENERATION PARAMETERS 

The 32-In/Transition Detection module may be supported as a special device by a customized 
TX990 operating system. To generate a system which includes the module, initiate the system 
generation program GENTX, as described in section 9. During the device definition phase, define 
the module as a special device by responding to the GENTX prompts as shown in table M-1 . 

Table M-1. GENTX Parameters for the 32-In/Module 



Prompt 



CHASSIS 



DEV NAME 

DEVTYPE 

CRU BASE ADDR 

ACCESS MODE 

INT LEVEL 

or 
INT POSITION 

TIME-OUT COUNT 

CRU INT LINE 

ENTRY LABEL OF DSR 

ENTRY LABEL OF ROUTINE 

INT BRANCH LABEL 

EXTENSION DATA 



Response 

Number of the chassis to which the module is 
connected (0-7) 

1 to 4 character name (e.g., SD32) 

SD 

As shown in the chart on top of the chassis 

FILE 

As shown in chart on top of main chassis 

As shown in chart on expansion chassis 

Desired number, as described in section 9 

31 

DIGDSR 

INT321 

NONSOL 

carriage return 



M.2 INCLUDING THE DEVICE SERVICE ROUTINE 

When linking the object modules of the new operating system together, the module DIGDSR in file 
:DSRLIB/OBJ on the TX990 parts diskette must be included. 

M.3 SUPERVISOR CALL BLOCK FORMAT 

Figure M-1 shows the format of the I/O call block used for all 32-In/Transition module operations. 



M-1 
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00 


STATUS 


2 


I/O OPCODE 


LUNO 


4 


SYSTEM FLAGS 


USER FLAGS 


6 


GENERAL PURPOSE ADDRESS 


8 


RECORD LENGTH 


10 


CHARACTER COUNT 



-•^ 



(A)1 37508 

Figure M-1. 32-In/T Call Block Format 

The first three words of the block are standard for all I/O supervisor calls: 

Byte contains the supervisor call code (00) for I/O operation. 

Byte 1 is the reserved location where the system places a status code after completion of the 
operation. 

There are 4 status codes that may be returned by the system: 

00 — Normal Completion 

02 — Illegal Operation Code 

04 — Recorded Loss Due to Power Failure 

06 - Operation Timed Out Or Terminated Abnormally 

Byte 2 of the SCB contains the user placed I/O operation code: 

• OPEN (00) - The 32-In/Transition module is considered a file oriented device; therefore, 
an 'OPEN' operation should be performed before proceeding with any other operations. 
The 'OPEN' returns a status code of in byte 1 of the SVC block. 

• CLOSE (01) - The 'CLOSE' call ends I/O operation to the device and places a code of 
in the status byte of the SVC block. 

• READ 32 BITS (20i6) - The 'READ 32 BITS' call reads 32 bits of information from 
the module and places it at the location given by the address contained in bytes 6 and 7 
of the SCB. 






^ 
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• WRITE MASK ( 22i6 ) - The 'WRITE MASK' call outputs 32 bits of information located 
at the address given in bytes 6 and 7 of the SVC to the module. This data acts as a bit 
level interrupt mask. When a 'T is output to a particular line on the module this enables a 
board level interrupt. The computer however, does not recognize these board level 
interrupts until a 'READ INTERRUPTING BIT' call is executed. This call allows the 
computer to recognize any unmasked board interrupts according to the data in the 
'WRITE MASK' call. 

• READ INTERRUPTING BIT ( 21i6 ) - The 'READ INTERRUPTING BIT' call enabled 
the computer to recognize any board level interrupts set up previously by the 'WRITE 
MASK' I/O call. 

Byte 3 contains the 'LOGICAL UNIT NUMBER' (LUNO). 

Bytes 4 and 5 contain the system flags and user flags described in Section VII. 

Bytes 6 and 7 form a general purpose address which can be used for three separate operations. It 
(^^ provides for the (1) address of a two word mask, (2) the address of the interrupt data, and (3) the 

address of a two word block of data. These three addresses are described in the following 
paragraphs. 

When used with the 'WRITE MASK' I/O call, bytes 6 and 7 contain the address of a two word mask 
for enabling or disabling module interrupts. Any bits set to a '1' by the two word mask will enable a 
corresponding interrupt on the module. A bit reset to '0' will prevent an interrupt from occurring. 



j0^^^\. 
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When used* with a 'READ INTERRUPTING BIT' I/O call the module address of the interrupt data 
is returned by the system at the address given in bytes 6 and 7. The returned module address 
appears in the left-most byte of the word whose address is given in bytes 6 and 7, along with the 
status (1 or 0) of the particular line on the module that caused the interrupt. The configuration of 
the returned module data looks like this: 

BITS 0-1 2 3-7 8-15 



ST 



MOD ADDR 



(A)l 37509 

When used with a 'READ 32 BITS' I/O call, bytes 6 and 7 contain the address pointing to the 
location where the 32 bits of information are stored after the operation. 

Bytes 8 and 9 contain the maximum number of bytes to be transferred during any operation, 
therefore, a value of 4 must be placed here by the user during all operations. 

Bytes 10 and 1 1 contain the actual number of bytes transferred by the system. A value of 4 will be 
placed here by the DSR during any operation. 
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ALPHABETICAL INDEX 
INTRODUCTION 



The following index lists key words and concepts from the subject material of the manual 
together with the area(s) in the manual that supply major coverage of the listed concept. The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as "Section x" with the symbol 
X representing any numeric quantity. 

• Appendixes - References to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

^ • Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 

or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter; all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 



r 



• 






Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

Other entries in the Index - References to other entries in the index are preceded by 
the word "See" followed by the referenced entry. 
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Abort I/O Supervisor Call 7.6, 7.7 

Action, End 5.5 

Accessing Parameters Through the 

Control Program 4.5 

Activate Suspended Task Supervisor 

Call 6.2.7 

Activate Time Delay Task Supervisor 

Call 6.2.5 

Activating and Deactivating OCP 3.2 

Add Command 3.5.2.5 

All (A) Command 11.4 

Allocation Unit 1.3 

Area, Dynamic Task 1.1 

Assign Logical Unit Command 3.5.1.1 

Assign LUNO to Pathname 

Operation 7.2.19 

Automatic Overlay Loading 5.2 

Backspace Command 3.5.3.3 

Backup: 

Error Messages 10.5 

and Initialize Utility Program 10.1 

Backward Space Operation 7.2.9 

Bid Task Supervisor Call 6.2.1 

Binary to Decimal ASCII Supervisor 

Call, Convert 6.3.1 

Binary to Hexadecimal ASCII 

Supervisor Call, Convert 6.3.3 

Blank Compressed 1.3.2 

Block, Supervisor Call 5.6 

Boot Copy (BC) Command 8.5.1 

Breakpoint Command, Set 3.5.2.3 

Bspace Command 3.5.3.3 

Byte Allocation of Common Memory . . . .T4-1 

Call: 

Abort I/O Supervisor 7.6, 7.7 

Activate Suspended Task Supervisor . . 6.2.7 
Activate Time Delay Task 

Supervisor 6.2.5 

Bid Task Supervisor 6.2.1 

Block, Supervisor 5.6 

Change Priority Supervisor 6.2.2 

Convert: 

Binary to Decimal ASCII 
Supervisor 6.3.1 

Binary to Hexadecimal ASCII 
Supervisor 6.3.3 

Decimal ASCII to Binary 
Supervisor 6.3.2 

Hexadecimal ASCII to Binary 

Supervisor 6.3.4 

Date and Time Supervisor 6.6 

Disable Event Key Supervisor 6.7 

Do Not Suspend Supervisor 6.2.3 

Enable Event Key Supervisor 6.7 

End of Program Supervisor 6.2.9 

End of Task Supervisor 6.2.8 

File Utility Supervisor 7.3 

General I/O Supervisor 7.2 



Get: 
Common Data Address Supervisor . . 6.4.4 "^^ 

Data Supervisor 6.5.2 

Date and Time Supervisor 6.6.1 

Memory Supervisor 6.4.1 

Own ID Supervisor 6.2.11 

Parameters Supervisor 6.2.10 

System Table Supervisor 6.4.3 

I/O Supervisor 7.2 

Initialize Date and Time Supervisor . . 6.6.2 
Make Task Privileged Supervisor . . . .6.2.12 

Put Data Supervisor 6.5.1 

Release Memory Supervisor 6.4.2 

Return Common Data Supervisor .... 6.4.5 

Time Delay Supervisor 6.2.4 

Unconditional Wait Supervisor 6.2.6 

VDT: 

Character Input Supervisor 7.4.2 

Conditional Character Input 

Supervisor 7.4.3 

Utility Supervisor 7.4.1 ^^^^^ 

Wait for I/O Supervisor 7.5 ' 

Calls: 

Executive Supervisor T6-1 

I/O Supervisor Section VII 

Change: 
File Name: 

Operation 7.2.23 

(CN) Command 8.5.6 

Priority Supervisor Call 6.2.2 

Protection (CP) Command 8.5.7 

Volume Name (CV) Command 8.5.18 ^^..^ 

Character Mode 1.4.2 ] 

Character Set: 

ASR 33 Teleprinter TB-6 

Card Reader TB-4 

Line Printer TB-5 

733 or 743 Data Terminal TB-3 

911 Video Display Terminal TB-1 

913 Video Display Terminal TB-2 

Character Sets, Device Appendix B 

Clear Breakpoint Command 3.5.2.4 

Close: 

Operation 7.2.3 /m^ 

Unload Operation 7.2.6 

With EOF Operation 7.2.4 

Code Format, Compressed 

Object Appendix F 

Code, Illegal Interrupt TH-1 

Code Numbers: 

Device T7-4 

File T7-4 

Codes: 

Fatal Task Error TH-1 

I/O Error Appendix I 

Task State Appendix G 

Command: 

Add 3.5.2.5 

All (A) 11.4 

Assign Logical Unit 3.5.1.1 
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Backspace 3.5.3.3 

Boot Copy (BC) 8.5.1 

Change: 

File Name (CN) 8.5.6 

Protection (CP) 8.5.7 

Volume Name (CV) 8.5.18 

Clear Breakpoint 3.5.2.4 

Compress File (CM) 8.5.5 

Copy (C) 11.4 

Create File (CF) 8.5.3 

Define Output (DO) 8.5.8 

Delete: 

File (DF) 8.5.4 

Procedure 3.5.1.10 

Task 3.5.1.9 

Diskette: 

Dump (DD) 8.5.11 

Load (DL) 8.5.12 

Done (D) 11.4 

Dump: 

Memory 3.5.2.1 

Workspace 3.5.2.8 

Execute Task 3.5.1.5 

File: 

Dump (FD) 8.5.13 

Load (FL) 8.5.14 

Format 3.4 

SYSUTL 8.4 

Forward Space 3.5.3.2 

Initialize Date and Time 3.5.4.1 

(ID) 8.5.15 

Insert (I) ' 11.4 

Install Procedure 3.5.1.8 

Install Real Time Task 3.5.1.7 

Install Task 3.5.1.6 

Jump Instruction 3.5.2.7 

Kill I/O Operation 3.5.2.10 

Kill Task 3.5.2.9 

Load: 

Memory 3.5.2.2 

Program 3.5.1.3 

Real Time Program 3.5.1.4 

Map: 

Diskette (MD) 8.5.9 

File (MF) 8.5.10 

Print Time and Date 3.5.4.2 

(TI) 8.5.16 

Procedure Status 3.5.3.6 

Release Logical Unit 3.5.1.2 

Replace (R) 11.4 

Rewind Device 3.5.3.1 

Set: 

Breakpoint 3.5.2.3 

System File (SF) 8.5.2 

Skip (S) 11.4 

Status of I/O 3.5.3.5 

Subtract 3.5.2.6 

Task Status 3.5.3.4 

Terminate 3.5.5 

SYSUTL (TE) 8.5.17 

Trace 3.5.2.11 



Commands: 

OCP 3.5 

Task Support 3.5.1 

SYSUTL 8.1 

Common Memory T4-1 

Communication Package (OCP), 

Operator Section III 

Communications Register Unit (CRU) .... 5.4 
Compatability with RX990 and DXIO, 

TX990 Appendix E 

Completion Codes, VDT Utility T7-5 

Compress File: 

Operation 7.2.22 

(CM) Command 8.5.5 

Compressed Object Code 

Format Appendix F 

Control Keys, Special Keyboard 4.4.3 

Control Program: 1.6, Section IV, 4.1 

Accessing Parameters Through the 4.5 

Error Messages, TXDS T4-2 

Operator Interaction 4.4 

Prompts 4.4.1 

CONTROL/OBJ 9.5 

Convert: 

Binary to Decimal ASCII 
Supervisor Call 6.3.1 

Binary to Hexadecimal ASCII 
Supervisor Call 6.3.3 

Decimal ASCII to Binary Supervisor 
Call 6.3.2 

Hexadecimal ASCII to Binary 

Supervisor Call 6.3.4 

Copy (C) Command 11.4 

Create: 

File 1.3.2 

Operation 7.2.18 

File (CF) Command 8.5.3 

Data Division 5.1 

Data Terminal Character Set, 
733 or 743 TB-3 

Date and Time Supervisor Call 6.6 

Decrement Sector Number (D) 

Directive 13.4.2 

Default Values 4.4.2 

Define Output (DO) Command 8.5.8 

Definition Phase, GENTX 9.3.3 

Delay Supervisor Call, Time 6.2.4 

Delete File: 

(DF) Command 8.5.4 

Operation 7.2.20 

Delete: 

Procedure Command 3.5.1.10 

Protect File Operation 7.2.26 

Task Command 3.5.1.9 

Device: 

Character Sets Appendix B 

Code Numbers T7-4 

Keywords, GENTX T9-3 

Name 1.4.1 

Name Table (DNT) T2-1 
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Device (Cont.) 

Service Routines 1.7 

Diagnostic Task J. 3 

Direct Operation, Write 7.2.13 

Directive: 

Decrement Sector Number (D) 13.4.2 

Increment Sector Number (I) 13.4.1 

Modify Displayed Sector Data (M) . . . 13.4.7 

Print Display (P) 13.4.3 

Set Data Mode to ASCII (A) 13.4.4 

Set Data Mode to EBCDIC (E) 13.4.5 

Set Data Mode to Hexadecimal (H) . . 13.4.6 

Directives, Diskette Dump Utility T13-1 

Directory 13 

Disable Event Key Supervisor Call 6.7 

Diskette: 
Dump: 

Utility Directives T13-1 

(DSKDMP) Utility 

Program Section XIII 

Dump (DD) Command 8.5.11 

File 1.3.2 

Load (DL) Command 8.5.12 

Division: 

Data 5.1 

Procedure 5.1 

Do Not Suspend Supervisor Call 6.2.3 

Done (D) Command 11.4 

DSKDMP Error Messages 13.5 

DSR C.2 

DSRLIB/OBJ 9.5 

Dump Memory Command 3.5.2.1 

Dump Utility Directives, Diskette T13-1 

Dump (DSKDMP) Utility Program, 

Diskette Section XIII 

Dump Workspace Command 3.5.2.8 

Dump (DD) Command, Diskette 8.5.11 

Dump (FD) Command, File 8.5.13 

Dynamic: 

Task Area 11 

Tasks ..1.1 

DYNTSK/OBJ 9.5 

Enable Event Key Supervisor Call 6.7 

End Action 5.5 

End of Program Supervisor Call 6.2.9 

End of Task Supervisor Call 6.2.8 

Error Codes: 

Fatal Task TH-1 

I/O Appendix I 

Error Messages: 

BACKUP 10.5 

Control Program T4-2 

DSKDMP 13.5 

GENTX T9-6 

LIST80/80 12.1.2 

OBJMGR Tll-1 



OCP: 

General T3-2 

Operand T3-3 

SYSUTL T8-1 

TXDS Control Program T4-2 

Execute: 

Command 3.5.1.5 

Task Command 3.5.1.5 

Extended Operation Routines C.l 

Extension 1.4.1 

Fatal Task Error Codes TH-1 

Features, File Management 1.3 

File: 

Code Numbers T7-4 

Dump (FD) Command 8.5.13 

Load (FL) Command 8.5.14 

Management Features 1.3 

Management Tasks J.4 

Mode 1.4.2 

Name 1.4.1 

System 10.4 

Utility Supervisor Call 7.3 

Utility Task J.5 

Files: 

Program 1.3.4 

Relative Record 1.3.3 

Sequential 1.3.2 

FMPLIB/OBJ 9.5 

Format: 

Command 3.4 

SYSUTL Command 8.4 

32 In/T Call Block FM-1 

Forward Space: 

Command 3.5.3.2 

Operation 7.2.8 

GENTX: 

Definition Phase 9.3.3 

Device Keywords T9-3 

Error Messages T9-6 

Prompts T9-1 

Utility Program 9.1 

GENTX Parameters: 

for the 32-In/ Modules TM-1 

for the 5MT/6MT Modules TL-1 

General: 

Error Messages, OCP T3-2 

I/O Supervisor Call . .7.2 

Generation, System Section IX 

Get: 
Common Data Address Supervisor 

Call 6.4.4 

Data Supervisor Call , 6.5.2 

Date and Time Supervisor Call 6.6.1 

Memory Supervisor Call 6.4.1 

Own ID Supervisor Call 6.2.11 

Parameters Supervisor Call 6.2.10 

System Table Supervisor Call 6.4.3 



^ 
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^^^^ Hexadecimal ASCII to Binary Supervisor 
f^ Call, Convert 6.3.4 

I/O: 

Call Block, 5MT/6MT FL-1 

Error Codes Appendix I 

Logical 1 .4 

Mode 1.4.2 

Operations 7.2.1 

Operations Record Mode T7-3 

Supervisor 1.7 

Call 7.2 

Calls T7-1 

Illegal Interrupt Code TH-1 

IMAGE Format 1.3.4 

Increment Sector Number (I) Directive . . 13.4.1 

Initial Start Task J.2 

Initial States T9-5 

Initialize Date and Time: 

Command 3.5.4.1 

^p^ Supervisor Call 6.6.2 

r (ID) Command 8.5.15 

INPUT: Prompt 4.4.1.2 

Insert (I) Command 11.4 

Install Procedure Command 3.5.1.8 

Install Real Time Task Command .... 3.5.1.7 

Install Task Command 3.5.1.6 

Interaction, Control Program Operator ... .4.4 

Interfaces, Operator 1.6 

Interrupt Handler 1.1 

lOS 1.7 

l^''^^ Jump Instruction Command 3.5.2.7 

Keywords, GENTX Device T9-3 

Kill I/O Operation Command 3.5.2.10 

Kill Task Command 3.5.2.9 

LIST80/80 12.1 

Error Messages 12.1.2 

Utility Program Section XII 

Load: 
Memory Command 3.5.2.2 

r Program Command 3.5.1.3 
Real Time Program Command 3.5.1.4 

(DL) Command, Diskette 8.5.12 

(FL) Command, File 8.5.14 

Loading: 

Automatic Overlay 5.2 

the Operating System Section II 

Logical I/O 1.4 

Logical Unit Command, Release 3.5.1.2 

LUNO Assignment Operation, 
Release 7.2.21 

LUNOS 1.4 

Make Task Privileged Supervisor Call . .6.2.12 

Management: 

Features, File 1.3 

Tasks, File J.4 

Map Diskette (MD) Command 8.5.9 



Map File (MF) Command 8.5.10 

Memory Command: 

Dump 3.5.2.1 

Load 3.5.2.2 

Memory, Common 4.5 

Mode: 

Character 1.4.2 

File 1.4.2 

I/O 1.4.2 

Read Random L.3.2 

Read Sequential L.3.4 

Read Status L.3.1 

Record 1.4.2 

Write Random L.3.3 

Write Sequential L.3.5 

Modify Displayed Sector Data (M) 

Directive 13.4.7 

Modules, User-Supplied Appendix C 

Name: 

Device 1.4.1 

File 1.4.1 

Name Support Task, Volume J. 7 

Names, Volume 1.3.1 

Number: 

Release 1.1 

Version 1.1 

Object Manager (OBJMGR) Utility 

Program Section XI 

OBJMGR Error Messages TU-l 

OCP 1.6, Section III 

Activating and Deactivating 3.2 

Command Syntax T3-1 

Commands 3.5 

General Error Messages T3-2 

Operand Error Messages T3-3 

Task Support Commands 3.5.1 

OCPLIB/OBJ 9.5 

Open Operation 7.2.2 

Open Rewind Operation 7.2.5 

Operand Error Messages, OCP T3-3 

Operating System, Loading the .... Section II 

Operating System Modules, TX990 T9-7 

Operation: 

Assign LUNO to Pathname 7.2.19 

Backward Space 7.2.9 

Change File Name 7.2.23 

Close 7.2.3 

Close Unload 7.2.6 

Close with EOF 7.2.4 

Compress File 7.2.22 

Create File 7.2.18 

Delete File 7.2.20 

Delete Protect File 7.2.26 

Forward Space 7.2.8 

Open 7.2.2 

Open Rewind 7.2.5 

Read ASCII 7.2.10 

Read Device File Status 7.2.7 

Read Direct 7.2.1 1 



Index-5 



Digital Systems Division 




946259-9701 



Operationi(Cont.) 

Release LUNO Assignment 7.2.21 

Rewind 7.2.15 

Routines, Extended C.l 

Transmit/ Receive L.3.6 

Unload 7.2.16 

Unlock 7.2.17 

Unprotect File 7.2.24 

Verify Pathname Syntax 7.2.27 

Write ASCII 7.2.12 

Write Direct 7.2.13 

Write EOF 7.2.14 

Write Protect File 7.2.25 

Operations, I/O 7.2.1 

Operations Record Mode, I/O T7-3 

Operator: 
Communication Package 

(OCP) Section III 

Interaction, Control Program 4.4 

Interfaces 1.6 

OPTIONS: Prompt 4.4.1.4 

OUTPUT: Prompt 4.4.1.3 

Overlay Loading, Automatic 5.2 

Overlays 5.2 

Parameters, System Timing T9-2 

Pathnames 1.4.1 

Phase: 

Construction 9.3.4 

GENTX Definition 9.3.3 

Print Display (P) Directive 13.4.3 

Print Time and Date 3.5.4.2 

Command 3.5.4.2 

(TI) Command 8.5.16 

Priority Supervisor Call, Change 6.2.2 

Procedure: 

Command, Delete 3.5.1.10 

Command, Status 3.5.3.6 

Division 5.1 

Program: 

Backup and Initialize Utility 10.1 

Command, Load 3.5.1.3 

Control 1.6, Section IV, 4.1 

Diskette Dump (DSKDMP) 

Utility Section XIII 

Error Messages, TXDS Control T4-2 

Files 1.3.4 

GENTX Utility 9.1 

LIST80/80 (LIST80) Utility Section XII 

Object Manager (OBJMGR) 

Utility Section XI 

Operator Interaction, Control 4.4 

Prompts, Control 4.4.1 

System Utility Section VIII 

PROGRAM: Prompt 4.4.1.1 

Programming Tasks Section V 

Prompt: 

INPUT: 4.4.1.2 

OPTIONS: 4.4.1.4 

OUTPUT: 4.4.1.3 

PROGRAM: 4.4.1.1 



Prompts, GENTX T9-1 

Protect File Operation: 

Delete 7.2.26 

Write 7.2.25 

Protection (CP) Command, Change .... 8.5.7 

Put Data Supervisor Call 6.5.1 

Read ASCII Operation 7.2.10 

Read Device File Status Operation .... 7.2.7 

Read Direct Operation 7.2.11 

Read Random Mode L.3.2 

Read Sequential Mode L.3.4 

Read Status Mode L.3.1 

Real Time Program Command, Load . . 3.5.1.4 

Rebid Task J.6 

Record Mode 1.4.2 

Relative Record Files 1.3.3 

Release: 

Logical Unit Command 3.5.1.2 

LUNO Assignment Operation 7.2.21 

Memory Supervisor Call 6.4.2 

Number 1.1 

Replace (R) Command 11.4 

Return Common Data Supervisor Call . . 6.4.5 

Rewind Device Command 3.5.3.1 

Rewind Operation 7.2.15 

Routines: 

Device Service 1 .7 

Extended Operation C.l 

User-Supplied Supervisor Call C.l 

Scheduler, Task 1.1, 5.3 

Sentry, Task 5.3 

Sequential: 

Sequential Files 1.3.2 

Service Routines, Device 1.7 

Set: 

Breakpoint Command 3.5.2.3 

Data Mode to ASCII (A) Directive . . 13.4.4 
Data Mode to EBCDIC (E) 

Directive 13.4.5 

Data Mode to Hexadecimal (H) 

Directive 13.4.6 

System File (SF) Command 8.5.2 

Skip(S) Command 11.4 

Slice, Time 1.1, 5.3 

Special Keyboard Control Keys 4.4.3 

State Codes, Task Appendix G 

States, Initial T9-5 

Status of I/O Command 3.5.3.5 

Subtract Command 3.5.2.6 

Supervisor: 
Call: 

Abort I/O 7.6, 7.7 

Activate Suspended Task 6.2.7 

Activate Time Delay Task ....... 6.2.5 

Bid Task 6.2.1 

Block 5.6 

Change Priority 6.2.2 
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Supervisor (Cont.) 
Convert: 

Binary to Decimal ASCII 6.3.1 

Binary to Hexadecimal ASCII . . . 6.3.3 

Decimal ASCII to Binary 6.3.2 

Hexadecimal ASCII to Binary . . . 6.3.4 

Date and Time 6.6 

Disable Event Key 6.7 

Do Not Suspend 6.2.3 

Enable Event Key 6.7 

End of Program 6.2.9 

End of Task 6.2.8 

File Utility 7.3 

General I/O 7.2 

Get: 

Common Data Address 6.4.4 

Data 6.5.2 

Date and Time 6.6.1 

Memory 6.4.1 

Own ID 6.2.11 

Parameters 6.2.10 

System Table 6.4.3 

I/O 7.2 

Initialize Date and Time 6.6.2 

Make Task Privileged . .6.2.12 

Put Data 6.5.1 

Release Memory 6.4.2 

Return Common Data 6.4.5 

Routines, User-Supplies C.l 

Time Delay 6.2.4 

Unconditional Wait 6.2.6 

VDT: 

Character Input 7.4.2 

Conditional Character Input 7.4.3 

Utility 7.4.1 

Wait for I/O 7.5 

Calls: 

Executive T6-1 

I/O T7-1 

Support Commands, OCP Task 3.5.1 

Supported Hardware 1.2 

Syntax: 

Command 3.4 

OCP Command T3-1 

SYSUTL Command 8.4 

System: 

File 10.4 

File (SF) Command, Set 8.5.2 

Generation Section IX 

Table Supervisor Call, Get 6.4.3 

Task Definition T9-4 

Tasks Appendix J 

Timing Parameters T9-2 

Utility Program Section VIII 

SYSUTL: 8.1 

(TE) Command, Terminate 8.5.17 

Command Format 8.4 

Commands 8.1 

Error Messages T8-1 



Task: 

Area, Dynamic 1.1 

Command: 

Delete 3.5.1.9 

Execute 3.5.1.5 

Definition, System T9-4 

Diagnostic J. 3 

Dynamic 1.1 

File Utility J 5 

INSTALL/ DELETE Procedure J.8 

Initial Start J.2 

Rebid J.6 

Scheduler 1.1, 5.3 

Sentry 5.3 

State Codes Appendix G 

Status Command 3.5.3.4 

Support Commands, OCP 3.5.1 

Volume Name Support J 7 

TASKDF 9.1 

Tasks 1.1 

Dynamic l.i 

File Management J.4 

Programming Section V 

System Appendix J 

Terminal: 

Character Set: 

911 Video Display TB-1 

913 Video Display TB-2 

Terminate 3.2 

Command 3.5 5 

SYSUTL (TE) Command 8.5.17 

The Operating System, Loading .... Section II 
Time: 

Delay Supervisor Call 6.2.4 

Slice l.l, 5.3 

Supervisor Call, Date and 6.6 

Timing Parameters, System T9.2 

Trace Command 3.5.2.11 

Transmit/ Receive Operation L.3.6 

TXDS Control Program Error Messages . .T4-2 
TX990: 

Compatability with RX990 and 

E>X10 Appendix E 

Operating System Modules T9-7 

Unconditional Wait Supervisor Call .... 6.2.6 

Unit, Allocation I.3 

Unload Operation 7.2. 16 

Unlock Operation 7.2.17 

Unprotect File Operation 7.2.24 

User-Supplied: 

Modules Appendix C 

Supervisor Call Routines CI 

Utility: 

Completion Codes, VDT T7-5 

Directives, Diskette Dump T13-1 
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Utility (Cont.) 
Program: 

Backup and Initialize 10. 1 

Diskette Dump 

(DSKDMP) Section XIII 

GENTX ... * 9.1 

LIST80/80 (LIST80) Section XII 

Object Manager (OBJMGR) . . Section XI 

System Section VIII 

Supervisor Call Block, VDT F7-4 

Supervisor Call, File 7.3 

Supervisor Call, VDT 7.4.1 

Task, File J.5 

VDT 1.4.2 

Character Input Supervisor Call 7.4.2 

Conditional Character Input 

Supervisor Call 7.4.3 

Utility: 

Completion Codes T7-5 



Supervisor Call 7.4.1 

Supervisor Call Block F7-4 

Values, Default 4.4.2 

Verify Pathname Syntax Operation .... 7.2.27 

Version Number 1.1 

Video Display Terminal 1.4.2 

Volume: 

Name Support Task J.7 

Name (CV) Command, Change 8.5.18 

Names 1.3.1 

Wait for I/O Supervisor Call 7.5 

Workspace Command, Dump 3.5.2.8 

Write: 

ASCII Operation 7.2.12 

Direct Operation 7.2.13 

EOF Operation 7.2.14 

Protect File Operation 7.2.25 

Random Mode L.3.3 

Sequential Mode L.3.5 
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